@bongos/core 1.19.550 → 1.19.552

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 (34) hide show
  1. package/.bongos-core.json +69 -34
  2. package/.claude/skills/bug-triage/SKILL.md +191 -0
  3. package/clients/bongos-client/README.md +1 -1
  4. package/clients/bongos-client/bongos-client.global.js +2 -0
  5. package/clients/bongos-client/index.cjs +2 -0
  6. package/clients/bongos-client/index.d.ts +3 -0
  7. package/clients/bongos-client/index.mjs +2 -0
  8. package/docs/api/openapi.json +77 -2
  9. package/docs/api-reference.md +3 -2
  10. package/docs/file-map.md +1 -0
  11. package/docs/module-api-changelog.md +4 -0
  12. package/migrations/core_232_task_merge_provenance.sql +64 -0
  13. package/modules/dev-box/app/src/vendor/bongos-client.cjs +2 -0
  14. package/modules/government/catalog.js +1 -0
  15. package/modules/government/migrations/government_011_task_merge_metic.sql +38 -0
  16. package/modules/lifecycle/db-goals.js +2 -1
  17. package/modules/lifecycle/db-ship.js +147 -0
  18. package/modules/lifecycle/db.js +2 -0
  19. package/modules/lifecycle/done-when.js +3 -2
  20. package/modules/lifecycle/goal-rollup.js +6 -4
  21. package/modules/lifecycle/routes/tasks.js +42 -0
  22. package/modules/lifecycle/task-status.js +72 -0
  23. package/modules/lifecycle/version-close.js +2 -1
  24. package/package-lock.json +2 -2
  25. package/package.json +1 -1
  26. package/scripts/gds/bug-triage.js +292 -0
  27. package/scripts/gds/sequence.js +4 -2
  28. package/scripts/gds/triage.js +40 -21
  29. package/src/module-api.js +1 -1
  30. package/tests/abandon_task.mjs +17 -0
  31. package/tests/auto_satisfy_criteria.mjs +24 -2
  32. package/tests/bug_triage.mjs +205 -0
  33. package/tests/goal_sort_staleness.mjs +9 -3
  34. package/tests/task_merge.mjs +198 -0
package/.bongos-core.json CHANGED
@@ -2,22 +2,22 @@
2
2
  "artifact": "bongos-core",
3
3
  "manifest_schema": 1,
4
4
  "generator": "scripts/gds/package-core.js",
5
- "core_version": "1.19.550",
6
- "core_contract": "1.19.550",
7
- "source_commit": "c1759a04d89ed06abdc8dfe92880259633704aeb",
5
+ "core_version": "1.19.552",
6
+ "core_contract": "1.19.552",
7
+ "source_commit": "c33c4fe6dd1cf9319051a7bee1e9c940472549a5",
8
8
  "source_ref": "HEAD",
9
- "built_at": "2026-09-04T18:42:59.133Z",
9
+ "built_at": "2026-09-06T15:55:11.203Z",
10
10
  "redaction": {
11
11
  "model": "docs-redacted+functional-verbatim",
12
- "docs_redacted": 441,
12
+ "docs_redacted": 442,
13
13
  "agent_docs_stubbed": 24,
14
- "functional_verbatim": 2013,
14
+ "functional_verbatim": 2019,
15
15
  "rules": 3,
16
16
  "gate_literals": 3,
17
17
  "gate": "passed"
18
18
  },
19
- "file_count": 2478,
20
- "tree_sha256": "d36204b8544ce3a80ec2ac8a90bd182e3157116d8944fddb8b72468558c0244b",
19
+ "file_count": 2485,
20
+ "tree_sha256": "c628eebd2a60fa4e7346604f1f5507a913cfac851f45fc632f3eff4aedf36487",
21
21
  "files": [
22
22
  {
23
23
  "path": ".claude/skills/blocker-review/SKILL.md",
@@ -29,6 +29,11 @@
29
29
  "mode": "0000644",
30
30
  "sha256": "90de8b32fb4dac69d6e5c781d78489c36c40f00c4b07f062c0650cff08052203"
31
31
  },
32
+ {
33
+ "path": ".claude/skills/bug-triage/SKILL.md",
34
+ "mode": "0000644",
35
+ "sha256": "85481aea23304149520f1adcb7e2e8ab05b655c269dd2e38a6c04922013e9202"
36
+ },
32
37
  {
33
38
  "path": ".claude/skills/builder-backup/SKILL.md",
34
39
  "mode": "0000644",
@@ -367,12 +372,12 @@
367
372
  {
368
373
  "path": "clients/bongos-client/README.md",
369
374
  "mode": "0000644",
370
- "sha256": "b1abf8c13f89ba8fe2ebca540d1a8b22fac0ad293595e51f464e189dfaf1a1ad"
375
+ "sha256": "262491824b5d7b6005c69d8190d50f450320f02dc1333dc7ae029616aff9f018"
371
376
  },
372
377
  {
373
378
  "path": "clients/bongos-client/bongos-client.global.js",
374
379
  "mode": "0000644",
375
- "sha256": "1178634ee16c7b1a83defe0c6ece5754a92901370ce18f114a84d3922f7065ca"
380
+ "sha256": "fd5d716ec3ba7fbdb9fdaee076ef89048424248139ef7d4ea51c3983866dea90"
376
381
  },
377
382
  {
378
383
  "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -382,17 +387,17 @@
382
387
  {
383
388
  "path": "clients/bongos-client/index.cjs",
384
389
  "mode": "0000644",
385
- "sha256": "be9e267735c41c695157c01fb82efb9219c2f6769febfa46495395d6dcc887ec"
390
+ "sha256": "17753bb744e592f7d7871d33399536d9938b1b7d6c6249959bcbb4355688b557"
386
391
  },
387
392
  {
388
393
  "path": "clients/bongos-client/index.d.ts",
389
394
  "mode": "0000644",
390
- "sha256": "73e1e22f18262eb0cb73edfe58aef773f802bae33b68b9ca2e4430403d03d7c9"
395
+ "sha256": "1b28c414b039d21ab8105d1687cf6d75cde078238ac84b920885772cd5e9bdbf"
391
396
  },
392
397
  {
393
398
  "path": "clients/bongos-client/index.mjs",
394
399
  "mode": "0000644",
395
- "sha256": "f9c26f336f8b7808ed1c07e844191abd0de7bc39657dda5d0363f5d472b6c2c4"
400
+ "sha256": "779dc3d8970036513a0f8da8e4846bd6c0d2d4714de38390b14ede249e75a3f6"
396
401
  },
397
402
  {
398
403
  "path": "clients/bongos-client/package.json",
@@ -1767,12 +1772,12 @@
1767
1772
  {
1768
1773
  "path": "docs/api-reference.md",
1769
1774
  "mode": "0000644",
1770
- "sha256": "aef38c3ecd8942f0a38c56cbb390fd3590e785634d24e95660900a5140636b5f"
1775
+ "sha256": "5ec1ca7cb551994a31d644eeebd77795955bac39e6389feaf6e6a5ec0217c911"
1771
1776
  },
1772
1777
  {
1773
1778
  "path": "docs/api/openapi.json",
1774
1779
  "mode": "0000644",
1775
- "sha256": "923202b89890cc048769c8b05087181fa06ff126aa80aeaa4d9f669f4d96c27e"
1780
+ "sha256": "40d863b7b46cc3691298f9e48c254cda3b7f4ab23bb008712a55e75764a69dd1"
1776
1781
  },
1777
1782
  {
1778
1783
  "path": "docs/architecture.md",
@@ -2637,7 +2642,7 @@
2637
2642
  {
2638
2643
  "path": "docs/file-map.md",
2639
2644
  "mode": "0000644",
2640
- "sha256": "6085fdda80f0c961067a044b890358fa148415638854029e63f764e262594aeb"
2645
+ "sha256": "e7c193b1cca2fc3f59742e95f921fc65096a32fbbcfba16e4a3950448293a7ba"
2641
2646
  },
2642
2647
  {
2643
2648
  "path": "docs/handoff-template.md",
@@ -2647,7 +2652,7 @@
2647
2652
  {
2648
2653
  "path": "docs/module-api-changelog.md",
2649
2654
  "mode": "0000644",
2650
- "sha256": "d3af686f65da15d8a3c4e8e291b7c4e2a9c025e2cc78305d509165978412329f"
2655
+ "sha256": "2fb63f0c4427c7f7bff711fcf41f5637cca7b31a8009a21305530748b130e310"
2651
2656
  },
2652
2657
  {
2653
2658
  "path": "docs/modules-contract.md",
@@ -3644,6 +3649,11 @@
3644
3649
  "mode": "0000644",
3645
3650
  "sha256": "8ae32be783a4ca41637f56626bd83375aa4ae0755e701a0c0170eada8d8303b8"
3646
3651
  },
3652
+ {
3653
+ "path": "migrations/core_232_task_merge_provenance.sql",
3654
+ "mode": "0000644",
3655
+ "sha256": "5ed2ff8117e6650de621a1576062b27f2d6e84faf8860f9cb2aed45323a85aa6"
3656
+ },
3647
3657
  {
3648
3658
  "path": "modules/agents/lib/validate.js",
3649
3659
  "mode": "0000644",
@@ -4042,7 +4052,7 @@
4042
4052
  {
4043
4053
  "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
4044
4054
  "mode": "0000644",
4045
- "sha256": "be9e267735c41c695157c01fb82efb9219c2f6769febfa46495395d6dcc887ec"
4055
+ "sha256": "17753bb744e592f7d7871d33399536d9938b1b7d6c6249959bcbb4355688b557"
4046
4056
  },
4047
4057
  {
4048
4058
  "path": "modules/dev-box/app/test/unit.mjs",
@@ -4282,7 +4292,7 @@
4282
4292
  {
4283
4293
  "path": "modules/government/catalog.js",
4284
4294
  "mode": "0000644",
4285
- "sha256": "913b7ab33c6785903376b0bf7804d7d8d2db620112b983ae4c0368f33a6b8c0f"
4295
+ "sha256": "57b29298fa5707d3a1d59e78612d2b039b1559d26b8a9116812d5c76e9c3af87"
4286
4296
  },
4287
4297
  {
4288
4298
  "path": "modules/government/config.js",
@@ -4384,6 +4394,11 @@
4384
4394
  "mode": "0000644",
4385
4395
  "sha256": "2b729acbc94c933ff2558d59e3cb811e7725450f0d646f9d9bc89209c1340d0f"
4386
4396
  },
4397
+ {
4398
+ "path": "modules/government/migrations/government_011_task_merge_metic.sql",
4399
+ "mode": "0000644",
4400
+ "sha256": "ccd2cd14103bae00957227d037d41f76adaaddc639bd09808f244b0bc514e702"
4401
+ },
4387
4402
  {
4388
4403
  "path": "modules/government/module.json",
4389
4404
  "mode": "0000644",
@@ -5412,7 +5427,7 @@
5412
5427
  {
5413
5428
  "path": "modules/lifecycle/db-goals.js",
5414
5429
  "mode": "0000644",
5415
- "sha256": "3ad7f78cbad987307d2203facbc91cec879565f398f9893a0218bbf29fc061bb"
5430
+ "sha256": "713b7165b1dbbfe43a77db5678ea98ebb03e17209d7b7bee5dbd1fc416be5cc2"
5416
5431
  },
5417
5432
  {
5418
5433
  "path": "modules/lifecycle/db-grade.js",
@@ -5437,7 +5452,7 @@
5437
5452
  {
5438
5453
  "path": "modules/lifecycle/db-ship.js",
5439
5454
  "mode": "0000644",
5440
- "sha256": "d300392b7bf802d00ae79c55ad3b0d9413dc9bb56e7e1105f49656b39abb874a"
5455
+ "sha256": "e48d877a5951f02153c7384217421b2b04a3a1fed215b61ac41fc5b0b8355ded"
5441
5456
  },
5442
5457
  {
5443
5458
  "path": "modules/lifecycle/db-tasks.js",
@@ -5452,7 +5467,7 @@
5452
5467
  {
5453
5468
  "path": "modules/lifecycle/db.js",
5454
5469
  "mode": "0000644",
5455
- "sha256": "09d40dd2eaae47c4620993ad3db6a6db2d880cc499724d31ceff29604960fd64"
5470
+ "sha256": "df5de732d9484e1bcf801c657c78b618d1a0353a912cdb1ee4fdd2c9f121749c"
5456
5471
  },
5457
5472
  {
5458
5473
  "path": "modules/lifecycle/dead-deps.js",
@@ -5462,7 +5477,7 @@
5462
5477
  {
5463
5478
  "path": "modules/lifecycle/done-when.js",
5464
5479
  "mode": "0000644",
5465
- "sha256": "fab91acf54bea4fca254bfd420a9a934e6eae434101ff57ae2a1bed48d2342d5"
5480
+ "sha256": "4e276151342f0eab3d4c0cea1ed55db8716a1d3d4b40568966be495f4892c1f4"
5466
5481
  },
5467
5482
  {
5468
5483
  "path": "modules/lifecycle/est-advisory.js",
@@ -5502,7 +5517,7 @@
5502
5517
  {
5503
5518
  "path": "modules/lifecycle/goal-rollup.js",
5504
5519
  "mode": "0000644",
5505
- "sha256": "cd3c3c28e9e1361b1f02a8de7a973d0d4d87b916477af98b9032de87dfbc588d"
5520
+ "sha256": "1debae561ef745ba22440ea2b32f27dd567e9e7ed56f8a5509e90fc1ddecd10e"
5506
5521
  },
5507
5522
  {
5508
5523
  "path": "modules/lifecycle/goal-suggest.js",
@@ -5682,7 +5697,7 @@
5682
5697
  {
5683
5698
  "path": "modules/lifecycle/routes/tasks.js",
5684
5699
  "mode": "0000644",
5685
- "sha256": "0ba020342e32eb552532a3a34a57b19aa4bbe87f0cb89ace0c45f4c301d7a015"
5700
+ "sha256": "366cb9c60952539ab8a946f8cf757754163b6cd6764a6430777b4529c86c6a75"
5686
5701
  },
5687
5702
  {
5688
5703
  "path": "modules/lifecycle/routes/versions.js",
@@ -5719,6 +5734,11 @@
5719
5734
  "mode": "0000644",
5720
5735
  "sha256": "7ed98bbd3d4954808dc64228acb6899a96083081ecc241e81f2b5db9eb568f1f"
5721
5736
  },
5737
+ {
5738
+ "path": "modules/lifecycle/task-status.js",
5739
+ "mode": "0000644",
5740
+ "sha256": "28db8b28430bbb1bc901b300322ce42ed5e9254e0b934941d3647b83c92b2083"
5741
+ },
5722
5742
  {
5723
5743
  "path": "modules/lifecycle/task-visual-db.js",
5724
5744
  "mode": "0000644",
@@ -5737,7 +5757,7 @@
5737
5757
  {
5738
5758
  "path": "modules/lifecycle/version-close.js",
5739
5759
  "mode": "0000644",
5740
- "sha256": "d71d0c0583cfa873001c0e359d6ee6e0e0a26d846121064c25ed36a1d27054ae"
5760
+ "sha256": "a977d807adb1e73544d1c02f6231005c2dbbb1a491316a8160080fd279e1b7a0"
5741
5761
  },
5742
5762
  {
5743
5763
  "path": "modules/memory/CLAUDE.md",
@@ -7452,12 +7472,12 @@
7452
7472
  {
7453
7473
  "path": "package-lock.json",
7454
7474
  "mode": "0000644",
7455
- "sha256": "a0768e258949174041e701e168aeab239b06a4e1ccc58298a0438c241a34cc58"
7475
+ "sha256": "cc08dead6d4714851b7db549d9b6ad9829bbd0e22722fab29cef54f9b28f7693"
7456
7476
  },
7457
7477
  {
7458
7478
  "path": "package.json",
7459
7479
  "mode": "0000644",
7460
- "sha256": "24085dcaa56b6f1085b7f75682d68d4f124c7ff51a8eef763a9e2296dfee9e10"
7480
+ "sha256": "36e67dc71f4fced7aa31d42102c8ff9c424ded06dea1a6f2f67d45888e95e406"
7461
7481
  },
7462
7482
  {
7463
7483
  "path": "public-docs/index.html",
@@ -7644,6 +7664,11 @@
7644
7664
  "mode": "0000644",
7645
7665
  "sha256": "afcebfb8e8e8f7041ee9cbfce1e9b8a46a299feb5e6e89ce4e00273135b268db"
7646
7666
  },
7667
+ {
7668
+ "path": "scripts/gds/bug-triage.js",
7669
+ "mode": "0000644",
7670
+ "sha256": "70b8f34cd401395e828bcd7d2b1c3bf508d2f1e0918f998df034efb15b6783b8"
7671
+ },
7647
7672
  {
7648
7673
  "path": "scripts/gds/build-bongos.js",
7649
7674
  "mode": "0000644",
@@ -8477,7 +8502,7 @@
8477
8502
  {
8478
8503
  "path": "scripts/gds/sequence.js",
8479
8504
  "mode": "0000644",
8480
- "sha256": "52c43371c2e6e8f7ffeac588143167ffc43e0010bceb7137ebce4ed61eaa64e6"
8505
+ "sha256": "08b2165b899aa71983826789613d7eadd1bdded7f4ef12b05d7c1a60bb79337e"
8481
8506
  },
8482
8507
  {
8483
8508
  "path": "scripts/gds/session-cost.js",
@@ -8702,7 +8727,7 @@
8702
8727
  {
8703
8728
  "path": "scripts/gds/triage.js",
8704
8729
  "mode": "0000644",
8705
- "sha256": "39cbb3b02f4dd8fab80ad53d39b95c3d94666c65b3eed5fbb38995551d170617"
8730
+ "sha256": "dc494030979bf60de1d1423c68a07e36667e816d7e2a1652960cfbd17be4bfcc"
8706
8731
  },
8707
8732
  {
8708
8733
  "path": "scripts/gds/turn-end-sound.js",
@@ -9147,7 +9172,7 @@
9147
9172
  {
9148
9173
  "path": "src/module-api.js",
9149
9174
  "mode": "0000644",
9150
- "sha256": "9ac49d0373037ef2fa93837e2483adb5bda5c40514a2c8458489092c03f4d9fc"
9175
+ "sha256": "bd96dabd37302c58d3519dde872d4a77f20302b5da263dc829db0fda37654edb"
9151
9176
  },
9152
9177
  {
9153
9178
  "path": "src/module-loader/catalog.js",
@@ -9197,7 +9222,7 @@
9197
9222
  {
9198
9223
  "path": "tests/abandon_task.mjs",
9199
9224
  "mode": "0000644",
9200
- "sha256": "031b75aeb83322055c4d69ab5481b220a7a41ccbe950129b84f8bc80d7c75a40"
9225
+ "sha256": "ccfb5d3e85fd6bd34acc78d510edf20d037d344eca58706f3e3130fa6dce611c"
9201
9226
  },
9202
9227
  {
9203
9228
  "path": "tests/access_requests_invite.mjs",
@@ -9407,7 +9432,7 @@
9407
9432
  {
9408
9433
  "path": "tests/auto_satisfy_criteria.mjs",
9409
9434
  "mode": "0000644",
9410
- "sha256": "135d0af6b1535e50d68ed62baa36b616ba28888e899940cabf2f2940f3cd6f9d"
9435
+ "sha256": "548e6a477660bb5e5cb260a0d5821bc3e11201225e64cfa45611c2fae07c80b2"
9411
9436
  },
9412
9437
  {
9413
9438
  "path": "tests/autonomous_fit_protected_paths.mjs",
@@ -9599,6 +9624,11 @@
9599
9624
  "mode": "0000644",
9600
9625
  "sha256": "b9303554061efaea510ef42d774ab9017ac7258cc0bc08f684abca7408b3fa86"
9601
9626
  },
9627
+ {
9628
+ "path": "tests/bug_triage.mjs",
9629
+ "mode": "0000644",
9630
+ "sha256": "2bc6312ff72fffc04478d40adc60e57e031b52ed208adf1d88f78986e536623f"
9631
+ },
9602
9632
  {
9603
9633
  "path": "tests/build_info.mjs",
9604
9634
  "mode": "0000644",
@@ -10277,7 +10307,7 @@
10277
10307
  {
10278
10308
  "path": "tests/goal_sort_staleness.mjs",
10279
10309
  "mode": "0000644",
10280
- "sha256": "1c34a429a1e96c409e8f6e2199d79a0f75b95f25a2cd5f1a86b6f2e254d6ac40"
10310
+ "sha256": "cf399c4c8ea36f96bbdb1f68e36a71eb3d0f4965c3e88278c9387d92896e7db4"
10281
10311
  },
10282
10312
  {
10283
10313
  "path": "tests/goal_subtitle.mjs",
@@ -12214,6 +12244,11 @@
12214
12244
  "mode": "0000644",
12215
12245
  "sha256": "bc89502f571659477178d68047098cf6098030491ac5c5a82b46802474a48387"
12216
12246
  },
12247
+ {
12248
+ "path": "tests/task_merge.mjs",
12249
+ "mode": "0000644",
12250
+ "sha256": "2a16f120729c641de65cccf79f1583e2d2e68b72bf10277310991c1787dde2bf"
12251
+ },
12217
12252
  {
12218
12253
  "path": "tests/task_ownership_gate.mjs",
12219
12254
  "mode": "0000644",
@@ -0,0 +1,191 @@
1
+ ---
2
+ name: bug-triage
3
+ description: >-
4
+ Daily walk through open kind=bug tasks, which land with no triage gate and
5
+ accumulate near-duplicates. Groups likely dups for one batch verdict, then
6
+ walks what's left: merge into a canonical task or won't-fix. Mirrors
7
+ /idea-triage. Triggers on "/bug-triage", "triage bugs", "walk the bug
8
+ queue", "dedupe bugs". Metic+ rank only (not Xenos/Thetes).
9
+ ---
10
+
11
+ You are running the bug-triage session for Example. Open `kind=bug` tasks get
12
+ walked and verdicted, so near-duplicate reports don't sit forever as separate
13
+ claimable rows.
14
+
15
+ ## Why this exists (task 1001478, idea 244)
16
+
17
+ Since task 1003071, a `#bugs` report routes straight to a `kind=bug` task at
18
+ filing time — no inbox stop, no gate. That is correct for getting a report
19
+ into the queue fast, but it means nothing ever folds two reports of the same
20
+ underlying bug together the way `/idea-triage` folds duplicate ideas. This
21
+ skill is that missing step, built on a **task-merge primitive** (`tasks`
22
+ gained `merged_into_task_id` + `triage_note` in `core_232`, mirroring
23
+ `idea_inbox`'s `merged_into_idea_id` from `core_195`) that did not exist
24
+ before this task.
25
+
26
+ **A merge is `abandoned` + a target, not a new status.** `tasks.status` has no
27
+ `'merged'` value — adding one would touch every place that already enumerates
28
+ task statuses (the claimable feed, dependency satisfaction, the diagrams
29
+ state machine) to answer a question `abandoned` already answers: this task is
30
+ retired, and by owner ruling its dependents are stranded, not waiting (see
31
+ `modules/lifecycle/CLAUDE.md`). `merged_into_task_id` carries the one thing
32
+ bare abandon can't: which task absorbed it. Read `modules/lifecycle/db-ship.js`
33
+ `mergeTask`'s header comment for the full guard list before touching this
34
+ surface.
35
+
36
+ ## Rank gate — Metic+ only
37
+
38
+ **Gated to Metic+ (Metic, Archon); not Xenos or Thetes.** Merging or
39
+ won't-fixing a bug task reshapes the team's backlog the same way idea triage
40
+ does — `task.merge` and `task.abandon` are both floor-`metic` permissions
41
+ (`modules/government/catalog.js`). A sub-Metic can still **file** a bug (via
42
+ Discord `#bugs`, or `POST /tasks` if `task.create` allows it); they can't
43
+ verdict the queue.
44
+
45
+ **Enforce the gate at the very top of the session, before reading anything else:**
46
+
47
+ 1. Call `GET /api/gds/me` and read `builder.rank`. Compare case-insensitively.
48
+ 2. **If `rank` lowercases to `xenos` or `thetes`** → stop immediately. Tell the
49
+ builder: *"Bug triage is a Metic+ operation — merging or dismissing a bug
50
+ report reshapes the team's backlog. File new bugs via Discord `#bugs`;
51
+ ask an Archon to promote you if you need to triage them."* Do not list
52
+ open bugs, do not propose verdicts.
53
+ 3. **If `rank` lowercases to `metic` or `archon`** → proceed below.
54
+ 4. **If `rank` is absent** (pre-rank deployment) → treat the session as
55
+ available, the same pre-rank passthrough `/idea-triage` uses.
56
+
57
+ > Belt-and-braces: the server already rejects `POST /tasks/:id/merge` and
58
+ > `POST /tasks/:id/abandon` with `403 permission_forbidden` for a sub-Metic
59
+ > caller — this check just stops one early instead of after a wall of 403s.
60
+
61
+ ## What this skill does
62
+
63
+ 1. Lists open `kind=bug` tasks via `GET /api/gds/tasks?kind=bug&limit=1000`,
64
+ filtered to the still-open statuses (`backlog`, `ready`, `active`,
65
+ `blocked`, `completed`, `confirmed` — never `shipped` or `abandoned`,
66
+ the latter of which already includes merged-away duplicates).
67
+ 2. **Batches near-duplicate bug tasks** into one verdict per cluster
68
+ (`node scripts/gds/bug-triage.js`'s reuse of `triage.js`'s `clusterRecords`
69
+ — the same union-find/Jaccard core `/idea-triage`'s `clusterIdeas` uses,
70
+ generalized in task 1001478 so the algorithm is written once). Partitioned
71
+ by `goal_id`, not `kind` — every row here is already `kind='bug'`, so a
72
+ kind gate would be a no-op; two bug reports in unrelated goals describing
73
+ similar-sounding symptoms are not the same triage decision.
74
+ 3. For each remaining bug, prompts the user with: **merge** (this is the same
75
+ report as task N) or **won't-fix** (not a bug / already fixed / can't
76
+ reproduce — closes the report itself, folds into nothing).
77
+ 4. Applies each verdict via `POST /api/gds/tasks/:id/merge` or
78
+ `POST /api/gds/tasks/:id/abandon`.
79
+
80
+ **No "promote" step, unlike `/idea-triage`.** A bug report is already a task —
81
+ there is no shape question (goal vs criterion vs task) to work out, because
82
+ `task-classifier.js`'s auto-routing already decided `kind=bug` at capture
83
+ time. The only two questions triage adds are "is this the same as an existing
84
+ report" and "should this report be closed at all".
85
+
86
+ ## How to use
87
+
88
+ **Step 1 — fetch open bug tasks.**
89
+
90
+ ```
91
+ node scripts/gds/api.js GET "/api/gds/tasks?kind=bug&limit=1000"
92
+ ```
93
+
94
+ Filter client-side to the open statuses above. If nothing remains, print "bug
95
+ queue empty — nothing to triage today" and stop.
96
+
97
+ For a human at a terminal, `node scripts/gds/bug-triage.js` runs the whole
98
+ walk interactively instead — batching, per-task prompts, and the summary all
99
+ in one command, same shape as `node scripts/gds/triage.js`.
100
+
101
+ **Step 1.5 — batch near-duplicate bug reports BEFORE walking individually.**
102
+
103
+ Run `clusterRecords` (`scripts/gds/triage.js`, pure, no I/O) with
104
+ `textOf: t => t.title + ' ' + t.description`, `kindOf: t => t.goal_id`,
105
+ `timeOf: t => new Date(t.created_at)`. For each cluster it returns, offer the
106
+ user ONE decision covering the whole group:
107
+
108
+ > Cluster of 3 likely duplicates: #501 "Login button does nothing on
109
+ > Safari", #517 "Safari: login unresponsive", #530 "Login broken in Safari".
110
+ > **Keep #501 and merge the rest, dismiss all as won't-fix, walk them
111
+ > individually, or skip?**
112
+
113
+ - **Keep #N** → merge every other member into #N (`POST /tasks/:id/merge
114
+ {"into_task_id": N}`), leaving #N itself open — it still gets the normal
115
+ Step 2 walk below, since "which report is the real one" and "should it stay
116
+ open" are different decisions.
117
+ - **Won't-fix all** → every member abandoned with one shared reason.
118
+ - **Individually** → ignore the grouping for this cluster; each member
119
+ returns to the normal walk.
120
+ - **Skip** → leave the whole cluster open; it clusters again next triage.
121
+
122
+ `node scripts/gds/bug-triage.js` already runs this pass automatically before
123
+ its interactive walk — a human running the deterministic walker gets it for
124
+ free with no flag.
125
+
126
+ **Step 2 — walk the list, task by task.**
127
+
128
+ Present each remaining bug with:
129
+ - id, status, title
130
+ - description (full)
131
+ - goal_id, created_at
132
+
133
+ Then ask the user (concise prompt — the owner may not be a software engineer,
134
+ CLAUDE.md §2's portable default; frame in product/outcome terms, not
135
+ implementation):
136
+
137
+ > Bug #N: "{title}". {one-sentence summary of the report}. **Is this a
138
+ > duplicate of an existing bug, should it be closed as won't-fix, or should
139
+ > it stay open?**
140
+
141
+ **Step 3 — apply the verdict.**
142
+
143
+ **Merge** → ask which existing task N is the canonical one, then fold this
144
+ report into it:
145
+
146
+ ```
147
+ node scripts/gds/api.js POST /api/gds/tasks/<id>/merge --body '{"into_task_id":<N>,"reason":"same report as #N"}'
148
+ ```
149
+
150
+ The server refuses a self-merge (`merge_self`), a shipped source
151
+ (`cannot_merge_shipped`), a task with an active claim
152
+ (`task_has_active_claim`), a target that doesn't exist
153
+ (`merge_target_not_found`), and a target that is itself merged elsewhere
154
+ (`merge_target_merged` — it names where the chain ends; retarget there
155
+ instead of re-merging).
156
+
157
+ **Won't-fix** → dismiss with a reason (not a bug / already fixed / cannot
158
+ reproduce):
159
+
160
+ ```
161
+ node scripts/gds/api.js POST /api/gds/tasks/<id>/abandon --body '{"reason":"cannot reproduce on current build"}'
162
+ ```
163
+
164
+ **Keep open** is implicit — leave the task un-patched by not calling either
165
+ route. It will surface again next triage.
166
+
167
+ **Step 4 — surface a summary.**
168
+
169
+ Report to the user:
170
+ - Total walked
171
+ - Merged (count + which task each folded into)
172
+ - Won't-fixed (count + ids)
173
+ - Skipped / left open (count — these surface again next session)
174
+ - Remaining open bug count
175
+
176
+ ## Why we run this
177
+
178
+ The same reason `/idea-triage` runs daily: a queue nobody walks quietly fills
179
+ with near-duplicates that each cost a separate builder's attention to
180
+ discover independently. A fast pass with mostly "skip" verdicts beats
181
+ skipping the session entirely — the cadence is the discipline.
182
+
183
+ ## Tone for the user
184
+
185
+ The owner is the prompter (CLAUDE.md §2's portable default). Frame merge/
186
+ won't-fix decisions in terms of what's actually broken for the end user, not
187
+ implementation: "these
188
+ are the same login failure reported twice" not "these share 71% word
189
+ overlap." Decide the mechanical merge target yourself; ask the human only
190
+ when two reports are genuinely ambiguous (different symptoms that might
191
+ share one root cause, say) rather than obviously the same.
@@ -5,7 +5,7 @@ A **generated**, zero-dependency typed client for the Bongos API — produced fr
5
5
  by hand; it regenerates when the spec changes, so it can never drift from the routes.
6
6
 
7
7
  - API version: **v1** (served at `/api/bongos/v1`)
8
- - 355 operations across 55 resource groups
8
+ - 356 operations across 55 resource groups
9
9
 
10
10
  ## Install
11
11
 
@@ -849,6 +849,8 @@ function createClient(opts = {}) {
849
849
  deleteTasksIdDependenciesDepId: (args) => request("DELETE", "/tasks/{id}/dependencies/{depId}", { hasBody: false }, args),
850
850
  // POST /tasks/{id}/grade — rank: any-builder — POST /tasks/:id/grade
851
851
  postTasksIdGrade: (args) => request("POST", "/tasks/{id}/grade", { hasBody: true }, args),
852
+ // POST /tasks/{id}/merge — rank: metic+archon — POST /tasks/:id/merge
853
+ postTasksIdMerge: (args) => request("POST", "/tasks/{id}/merge", { hasBody: true }, args),
852
854
  // POST /tasks/{id}/override-request — rank: any-builder — POST /tasks/:id/override-request
853
855
  postTasksIdOverrideRequest: (args) => request("POST", "/tasks/{id}/override-request", { hasBody: true }, args),
854
856
  // POST /tasks/{id}/promote — rank: metic+archon — POST /tasks/:id/promote
@@ -848,6 +848,8 @@ function createClient(opts = {}) {
848
848
  deleteTasksIdDependenciesDepId: (args) => request("DELETE", "/tasks/{id}/dependencies/{depId}", { hasBody: false }, args),
849
849
  // POST /tasks/{id}/grade — rank: any-builder — POST /tasks/:id/grade
850
850
  postTasksIdGrade: (args) => request("POST", "/tasks/{id}/grade", { hasBody: true }, args),
851
+ // POST /tasks/{id}/merge — rank: metic+archon — POST /tasks/:id/merge
852
+ postTasksIdMerge: (args) => request("POST", "/tasks/{id}/merge", { hasBody: true }, args),
851
853
  // POST /tasks/{id}/override-request — rank: any-builder — POST /tasks/:id/override-request
852
854
  postTasksIdOverrideRequest: (args) => request("POST", "/tasks/{id}/override-request", { hasBody: true }, args),
853
855
  // POST /tasks/{id}/promote — rank: metic+archon — POST /tasks/:id/promote
@@ -371,6 +371,7 @@ export interface PostTasksIdDemoteResponse { ok: boolean }
371
371
  export interface PostTasksIdDependenciesRequest { depends_on_task_ids?: unknown[]; depends_on_task_id?: StringifiableId }
372
372
  export interface PostTasksIdDependenciesResponse { ok: boolean; added: unknown; dependencies: unknown }
373
373
  export interface PostTasksIdGradeRequest { subagent_output?: unknown; signals?: Record<string, unknown>; committed_files?: string[]; diff_hash?: string }
374
+ export interface PostTasksIdMergeRequest { into_task_id: number; reason?: string }
374
375
  export interface PostTasksIdOverrideRequestRequest { rationale: string }
375
376
  export interface PostTasksIdOverrideRequestResponse { ok: boolean; request: unknown }
376
377
  export interface PostTasksIdPublishBranchRequest { branch: string; head_sha: string; bundle_b64: string; value_summary?: string }
@@ -1172,6 +1173,8 @@ export interface BongosClient {
1172
1173
  deleteTasksIdDependenciesDepId(args?: RequestArgs): Promise<DeleteTasksIdDependenciesDepIdResponse>;
1173
1174
  /** POST /tasks/{id}/grade — rank: any-builder */
1174
1175
  postTasksIdGrade(args?: RequestArgs & { body?: PostTasksIdGradeRequest }): Promise<ApiResponse>;
1176
+ /** POST /tasks/{id}/merge — rank: metic+archon */
1177
+ postTasksIdMerge(args: RequestArgs & { body: PostTasksIdMergeRequest }): Promise<ApiResponse>;
1175
1178
  /** POST /tasks/{id}/override-request — rank: any-builder */
1176
1179
  postTasksIdOverrideRequest(args: RequestArgs & { body: PostTasksIdOverrideRequestRequest }): Promise<PostTasksIdOverrideRequestResponse>;
1177
1180
  /** POST /tasks/{id}/promote — rank: metic+archon */
@@ -845,6 +845,8 @@ export function createClient(opts = {}) {
845
845
  deleteTasksIdDependenciesDepId: (args) => request("DELETE", "/tasks/{id}/dependencies/{depId}", { hasBody: false }, args),
846
846
  // POST /tasks/{id}/grade — rank: any-builder — POST /tasks/:id/grade
847
847
  postTasksIdGrade: (args) => request("POST", "/tasks/{id}/grade", { hasBody: true }, args),
848
+ // POST /tasks/{id}/merge — rank: metic+archon — POST /tasks/:id/merge
849
+ postTasksIdMerge: (args) => request("POST", "/tasks/{id}/merge", { hasBody: true }, args),
848
850
  // POST /tasks/{id}/override-request — rank: any-builder — POST /tasks/:id/override-request
849
851
  postTasksIdOverrideRequest: (args) => request("POST", "/tasks/{id}/override-request", { hasBody: true }, args),
850
852
  // POST /tasks/{id}/promote — rank: metic+archon — POST /tasks/:id/promote