nexus-agents 2.72.1 → 2.74.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 (112) hide show
  1. package/dist/{adaptive-memory-UPE76IP6.js → adaptive-memory-OJY3IVNM.js} +3 -3
  2. package/dist/{child-mcp-config-5HRJGLCR.js → child-mcp-config-KMCKKPNY.js} +2 -2
  3. package/dist/{chunk-TF3GROMO.js → chunk-2SVS5WRV.js} +2 -2
  4. package/dist/{chunk-QECRZ3YA.js → chunk-3ESCBV47.js} +2 -2
  5. package/dist/{chunk-QL4HCYRD.js → chunk-3SZBDLFX.js} +3 -3
  6. package/dist/{chunk-VTVKC4FS.js → chunk-44MVIL3F.js} +4 -4
  7. package/dist/{chunk-BVETPIOQ.js → chunk-4K6L7RKC.js} +3 -3
  8. package/dist/chunk-4K6L7RKC.js.map +1 -0
  9. package/dist/{chunk-C3JGKBL2.js → chunk-65R32U3M.js} +4 -4
  10. package/dist/{chunk-3FIDMWFC.js → chunk-BK54O5J5.js} +2 -2
  11. package/dist/chunk-BK54O5J5.js.map +1 -0
  12. package/dist/{chunk-J4VR2WNI.js → chunk-BYKS53GW.js} +1086 -1709
  13. package/dist/chunk-BYKS53GW.js.map +1 -0
  14. package/dist/{chunk-L6N2S3UB.js → chunk-CCODJRS6.js} +2 -2
  15. package/dist/{chunk-DA5UDQYW.js → chunk-DGELGUZF.js} +2 -2
  16. package/dist/{chunk-2KB63QGE.js → chunk-EQHYXT56.js} +2 -2
  17. package/dist/{chunk-VPC3YNFR.js → chunk-G5VE2DZS.js} +2 -2
  18. package/dist/{chunk-2MD5MWCK.js → chunk-GS3GW7C7.js} +2 -2
  19. package/dist/{chunk-ES6GFP35.js → chunk-NC2LECY6.js} +26 -9
  20. package/dist/chunk-NC2LECY6.js.map +1 -0
  21. package/dist/{chunk-5MHIWRKB.js → chunk-NQR7QAZX.js} +21 -2
  22. package/dist/chunk-NQR7QAZX.js.map +1 -0
  23. package/dist/{chunk-5WQ3SRSE.js → chunk-PAFH336F.js} +2 -2
  24. package/dist/{chunk-O4KUCF5S.js → chunk-Q3RFPJYK.js} +1325 -441
  25. package/dist/chunk-Q3RFPJYK.js.map +1 -0
  26. package/dist/{chunk-P5OFZWDW.js → chunk-Q6JDV36D.js} +13 -6
  27. package/dist/chunk-Q6JDV36D.js.map +1 -0
  28. package/dist/{chunk-A35XORXU.js → chunk-Q7FTNKPO.js} +2 -2
  29. package/dist/chunk-QON7LR7J.js +153 -0
  30. package/dist/chunk-QON7LR7J.js.map +1 -0
  31. package/dist/{chunk-53K3KEKT.js → chunk-T5VPZZYX.js} +1564 -848
  32. package/dist/chunk-T5VPZZYX.js.map +1 -0
  33. package/dist/{chunk-TQFRPFMG.js → chunk-TBRNRW2Q.js} +2 -2
  34. package/dist/{chunk-345KMHWH.js → chunk-UWJKMBPL.js} +6 -6
  35. package/dist/{chunk-V7ATY4BG.js → chunk-VJD5LANR.js} +14 -16
  36. package/dist/chunk-VJD5LANR.js.map +1 -0
  37. package/dist/{chunk-YOREAPF6.js → chunk-WCCTIRSB.js} +11 -10
  38. package/dist/chunk-WCCTIRSB.js.map +1 -0
  39. package/dist/{cli-circuit-breaker-GFF2RLBZ.js → cli-circuit-breaker-STXIH563.js} +4 -4
  40. package/dist/cli.d.ts +5 -2
  41. package/dist/cli.js +138 -106
  42. package/dist/cli.js.map +1 -1
  43. package/dist/{composite-router-33F3F74I.js → composite-router-7AHZN3VI.js} +2 -2
  44. package/dist/{consensus-vote-5V4KVHBE.js → consensus-vote-XY55C7WQ.js} +11 -10
  45. package/dist/consensus-vote-types-CoGbAEjf.d.ts +195 -0
  46. package/dist/{doctor-deep-AHDTNURD.js → doctor-deep-ONHJTGR4.js} +3 -3
  47. package/dist/{expert-bridge-DMDHHDEU.js → expert-bridge-3AWQHR65.js} +3 -3
  48. package/dist/{factory-FVD7PZ6S.js → factory-E5NMAMZC.js} +5 -5
  49. package/dist/{factory-VQS3HJ7V.js → factory-HWHQ44BB.js} +4 -4
  50. package/dist/index.d.ts +4089 -3693
  51. package/dist/index.js +85 -73
  52. package/dist/index.js.map +1 -1
  53. package/dist/{init-opencode-EIOIPVWL.js → init-opencode-Z7OQ5RCB.js} +5 -5
  54. package/dist/{issue-triage-HJUJWGAD.js → issue-triage-UWBHMQHC.js} +4 -4
  55. package/dist/{mobimem-BOJFXQ7B.js → mobimem-G4UXJTCV.js} +2 -2
  56. package/dist/{registry-command-NCWUJKAF.js → registry-command-HYWVRAHE.js} +5 -6
  57. package/dist/registry-command-HYWVRAHE.js.map +1 -0
  58. package/dist/{repo-security-plan-3J45VAD6.js → repo-security-plan-W35CXK3T.js} +3 -3
  59. package/dist/{research-helpers-synthesize-UGQHZZJN.js → research-helpers-synthesize-GUQORWL4.js} +3 -3
  60. package/dist/{routing-memory-NO7QEH7T.js → routing-memory-VOJBOX3X.js} +2 -2
  61. package/dist/{session-memory-DOXLEWEU.js → session-memory-B6LQMF4N.js} +3 -3
  62. package/dist/{setup-command-BWUFMZ7U.js → setup-command-CTC5YNA4.js} +9 -8
  63. package/dist/{setup-config-E3JZYSLR.js → setup-config-53MHJA7S.js} +3 -3
  64. package/dist/{setup-custom-api-DHJ5DRH2.js → setup-custom-api-VD5W754A.js} +4 -4
  65. package/dist/{weather-report-FNN4OX3N.js → weather-report-APASTJDQ.js} +2 -2
  66. package/package.json +1 -1
  67. package/dist/chunk-3FIDMWFC.js.map +0 -1
  68. package/dist/chunk-53K3KEKT.js.map +0 -1
  69. package/dist/chunk-5MHIWRKB.js.map +0 -1
  70. package/dist/chunk-BVETPIOQ.js.map +0 -1
  71. package/dist/chunk-ES6GFP35.js.map +0 -1
  72. package/dist/chunk-J4VR2WNI.js.map +0 -1
  73. package/dist/chunk-O4KUCF5S.js.map +0 -1
  74. package/dist/chunk-P5OFZWDW.js.map +0 -1
  75. package/dist/chunk-V7ATY4BG.js.map +0 -1
  76. package/dist/chunk-YOREAPF6.js.map +0 -1
  77. package/dist/model-capabilities-types-B57GZryc.d.ts +0 -18
  78. package/dist/registry-command-NCWUJKAF.js.map +0 -1
  79. /package/dist/{adaptive-memory-UPE76IP6.js.map → adaptive-memory-OJY3IVNM.js.map} +0 -0
  80. /package/dist/{child-mcp-config-5HRJGLCR.js.map → child-mcp-config-KMCKKPNY.js.map} +0 -0
  81. /package/dist/{chunk-TF3GROMO.js.map → chunk-2SVS5WRV.js.map} +0 -0
  82. /package/dist/{chunk-QECRZ3YA.js.map → chunk-3ESCBV47.js.map} +0 -0
  83. /package/dist/{chunk-QL4HCYRD.js.map → chunk-3SZBDLFX.js.map} +0 -0
  84. /package/dist/{chunk-VTVKC4FS.js.map → chunk-44MVIL3F.js.map} +0 -0
  85. /package/dist/{chunk-C3JGKBL2.js.map → chunk-65R32U3M.js.map} +0 -0
  86. /package/dist/{chunk-L6N2S3UB.js.map → chunk-CCODJRS6.js.map} +0 -0
  87. /package/dist/{chunk-DA5UDQYW.js.map → chunk-DGELGUZF.js.map} +0 -0
  88. /package/dist/{chunk-2KB63QGE.js.map → chunk-EQHYXT56.js.map} +0 -0
  89. /package/dist/{chunk-VPC3YNFR.js.map → chunk-G5VE2DZS.js.map} +0 -0
  90. /package/dist/{chunk-2MD5MWCK.js.map → chunk-GS3GW7C7.js.map} +0 -0
  91. /package/dist/{chunk-5WQ3SRSE.js.map → chunk-PAFH336F.js.map} +0 -0
  92. /package/dist/{chunk-A35XORXU.js.map → chunk-Q7FTNKPO.js.map} +0 -0
  93. /package/dist/{chunk-TQFRPFMG.js.map → chunk-TBRNRW2Q.js.map} +0 -0
  94. /package/dist/{chunk-345KMHWH.js.map → chunk-UWJKMBPL.js.map} +0 -0
  95. /package/dist/{cli-circuit-breaker-GFF2RLBZ.js.map → cli-circuit-breaker-STXIH563.js.map} +0 -0
  96. /package/dist/{composite-router-33F3F74I.js.map → composite-router-7AHZN3VI.js.map} +0 -0
  97. /package/dist/{consensus-vote-5V4KVHBE.js.map → consensus-vote-XY55C7WQ.js.map} +0 -0
  98. /package/dist/{doctor-deep-AHDTNURD.js.map → doctor-deep-ONHJTGR4.js.map} +0 -0
  99. /package/dist/{expert-bridge-DMDHHDEU.js.map → expert-bridge-3AWQHR65.js.map} +0 -0
  100. /package/dist/{factory-FVD7PZ6S.js.map → factory-E5NMAMZC.js.map} +0 -0
  101. /package/dist/{factory-VQS3HJ7V.js.map → factory-HWHQ44BB.js.map} +0 -0
  102. /package/dist/{init-opencode-EIOIPVWL.js.map → init-opencode-Z7OQ5RCB.js.map} +0 -0
  103. /package/dist/{issue-triage-HJUJWGAD.js.map → issue-triage-UWBHMQHC.js.map} +0 -0
  104. /package/dist/{mobimem-BOJFXQ7B.js.map → mobimem-G4UXJTCV.js.map} +0 -0
  105. /package/dist/{repo-security-plan-3J45VAD6.js.map → repo-security-plan-W35CXK3T.js.map} +0 -0
  106. /package/dist/{research-helpers-synthesize-UGQHZZJN.js.map → research-helpers-synthesize-GUQORWL4.js.map} +0 -0
  107. /package/dist/{routing-memory-NO7QEH7T.js.map → routing-memory-VOJBOX3X.js.map} +0 -0
  108. /package/dist/{session-memory-DOXLEWEU.js.map → session-memory-B6LQMF4N.js.map} +0 -0
  109. /package/dist/{setup-command-BWUFMZ7U.js.map → setup-command-CTC5YNA4.js.map} +0 -0
  110. /package/dist/{setup-config-E3JZYSLR.js.map → setup-config-53MHJA7S.js.map} +0 -0
  111. /package/dist/{setup-custom-api-DHJ5DRH2.js.map → setup-custom-api-VD5W754A.js.map} +0 -0
  112. /package/dist/{weather-report-FNN4OX3N.js.map → weather-report-APASTJDQ.js.map} +0 -0
@@ -1,12 +1,12 @@
1
1
  import {
2
2
  discoverModels,
3
3
  readOpencodeGateway
4
- } from "./chunk-P5OFZWDW.js";
5
- import "./chunk-BVETPIOQ.js";
6
- import "./chunk-5MHIWRKB.js";
4
+ } from "./chunk-Q6JDV36D.js";
5
+ import "./chunk-4K6L7RKC.js";
6
+ import "./chunk-NQR7QAZX.js";
7
7
  import {
8
8
  createLogger
9
- } from "./chunk-O4KUCF5S.js";
9
+ } from "./chunk-Q3RFPJYK.js";
10
10
  import "./chunk-I7ORMAO7.js";
11
11
  import "./chunk-GOT7OAL5.js";
12
12
  import "./chunk-UP2VWCW5.js";
@@ -155,4 +155,4 @@ export {
155
155
  runInitOpencode,
156
156
  runOpencodeValidate
157
157
  };
158
- //# sourceMappingURL=init-opencode-EIOIPVWL.js.map
158
+ //# sourceMappingURL=init-opencode-Z7OQ5RCB.js.map
@@ -2,9 +2,9 @@ import {
2
2
  IssueTriage,
3
3
  createIssueTriage,
4
4
  formatTriageComment
5
- } from "./chunk-V7ATY4BG.js";
6
- import "./chunk-3FIDMWFC.js";
7
- import "./chunk-O4KUCF5S.js";
5
+ } from "./chunk-VJD5LANR.js";
6
+ import "./chunk-BK54O5J5.js";
7
+ import "./chunk-Q3RFPJYK.js";
8
8
  import "./chunk-I7ORMAO7.js";
9
9
  import "./chunk-GOT7OAL5.js";
10
10
  import "./chunk-UP2VWCW5.js";
@@ -13,4 +13,4 @@ export {
13
13
  createIssueTriage,
14
14
  formatTriageComment
15
15
  };
16
- //# sourceMappingURL=issue-triage-HJUJWGAD.js.map
16
+ //# sourceMappingURL=issue-triage-UWBHMQHC.js.map
@@ -2,7 +2,7 @@ import {
2
2
  DEFAULT_MOBIMEM_CONFIG,
3
3
  MobiMem,
4
4
  createMobiMem
5
- } from "./chunk-O4KUCF5S.js";
5
+ } from "./chunk-Q3RFPJYK.js";
6
6
  import "./chunk-I7ORMAO7.js";
7
7
  import "./chunk-GOT7OAL5.js";
8
8
  import "./chunk-UP2VWCW5.js";
@@ -11,4 +11,4 @@ export {
11
11
  MobiMem,
12
12
  createMobiMem
13
13
  };
14
- //# sourceMappingURL=mobimem-BOJFXQ7B.js.map
14
+ //# sourceMappingURL=mobimem-G4UXJTCV.js.map
@@ -1,9 +1,8 @@
1
1
  import {
2
- DEFAULT_MODEL_CAPABILITIES,
3
2
  ModelCapabilitySchema,
4
3
  createLogger,
5
- getModelCapabilities
6
- } from "./chunk-O4KUCF5S.js";
4
+ getInTreeCapabilitiesMatrix
5
+ } from "./chunk-Q3RFPJYK.js";
7
6
  import "./chunk-I7ORMAO7.js";
8
7
  import {
9
8
  nexusDataPath
@@ -216,7 +215,7 @@ var CapabilityDiscovery = class {
216
215
  logger;
217
216
  generatedById;
218
217
  constructor(config = {}) {
219
- this.canonical = config.canonical ?? DEFAULT_MODEL_CAPABILITIES;
218
+ this.canonical = config.canonical ?? getInTreeCapabilitiesMatrix();
220
219
  this.generated = config.generated ?? null;
221
220
  this.overlay = config.overlay ?? [];
222
221
  this.fallback = config.conservativeDefault ?? LEGACY_200K_DEFAULT;
@@ -258,7 +257,7 @@ var CapabilityDiscovery = class {
258
257
  return this.overlay.find((m) => m.id === modelId);
259
258
  }
260
259
  lookupCanonical(modelId) {
261
- return getModelCapabilities(modelId, this.canonical);
260
+ return this.canonical.models.find((m) => m.id === modelId);
262
261
  }
263
262
  lookupGenerated(modelId) {
264
263
  const direct = this.generatedById.get(modelId);
@@ -577,4 +576,4 @@ export {
577
576
  isValidRegistrySubcommand,
578
577
  registryCommand
579
578
  };
580
- //# sourceMappingURL=registry-command-NCWUJKAF.js.map
579
+ //# sourceMappingURL=registry-command-HYWVRAHE.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/registry-command.ts","../src/config/capability-discovery.ts","../src/config/capability-overlay.ts"],"sourcesContent":["/**\n * `nexus-agents registry` CLI subcommands (epic #2174 / issue #2179).\n *\n * Two subcommands:\n *\n * - `doctor` — inspect CapabilityDiscovery state: tier counts, overlay /\n * bundled paths and status, configured conservative default. Surfaces\n * whatever T3 overlay parse rejections occurred at load. Read-only.\n *\n * - `refresh` — download a signed `model-registry.generated.json` from a\n * URL, SHA256-verify against a `.sha256` sidecar, write to the user's\n * overlay location. Requires `--source=<url>` today; the GitHub-latest-\n * release automation is #2180's concern.\n *\n * No runtime hot path touches the network — refresh is a one-shot,\n * user-initiated operation.\n *\n * @module cli/registry-command\n */\n\nimport { createHash } from 'node:crypto';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport { nexusDataPath } from '../config/nexus-data-dir.js';\n\nimport {\n defaultGeneratedRegistryPath,\n getCapabilityDiscovery,\n loadBundledGeneratedRegistry,\n type ResolutionTier,\n} from '../config/capability-discovery.js';\nimport {\n OVERLAY_ENV_VAR,\n OVERLAY_MAX_BYTES,\n defaultOverlayPath,\n loadCapabilityOverlay,\n resolveOverlayPath,\n} from '../config/capability-overlay.js';\n\n// ---------------------------------------------------------------------------\n// Dispatch\n// ---------------------------------------------------------------------------\n\nexport type RegistrySubcommand = 'doctor' | 'refresh';\n\nconst VALID_SUBCOMMANDS: readonly RegistrySubcommand[] = ['doctor', 'refresh'];\n\nexport function isValidRegistrySubcommand(v: string | undefined): v is RegistrySubcommand {\n return v !== undefined && (VALID_SUBCOMMANDS as readonly string[]).includes(v);\n}\n\nexport interface RegistryCommandOptions {\n readonly json?: boolean;\n readonly source?: string;\n readonly dryRun?: boolean;\n readonly overlayPath?: string;\n /** For tests: a fetch function. Defaults to `globalThis.fetch`. */\n readonly fetchImpl?: typeof fetch;\n /** For tests: override the default destination path. */\n readonly destPath?: string;\n}\n\nexport interface RegistryCommandResult {\n readonly text: string;\n readonly exitCode: number;\n}\n\nexport async function registryCommand(\n subcommand: RegistrySubcommand,\n options: RegistryCommandOptions = {}\n): Promise<RegistryCommandResult> {\n if (subcommand === 'doctor') return doctorCommand(options);\n return refreshCommand(options);\n}\n\n// ---------------------------------------------------------------------------\n// doctor\n// ---------------------------------------------------------------------------\n\ninterface DoctorReport {\n readonly tierCounts: Record<ResolutionTier, number>;\n readonly bundled: {\n readonly path: string;\n readonly present: boolean;\n readonly entryCount: number | null;\n readonly generatedAt: string | null;\n };\n readonly overlay: {\n readonly path: string;\n readonly status: 'missing' | 'empty' | 'malformed' | 'too-large' | 'loaded';\n readonly entryCount: number;\n readonly rejections: readonly { index: number; id?: string; reason: string }[];\n readonly envOverride: string | undefined;\n };\n readonly conservativeDefault: {\n readonly contextWindow: number;\n readonly maxOutputTokens: number | null;\n };\n}\n\nfunction doctorCommand(options: RegistryCommandOptions): RegistryCommandResult {\n const report = buildDoctorReport(options);\n if (options.json === true) {\n return { text: JSON.stringify(report, null, 2), exitCode: 0 };\n }\n return { text: formatDoctorReport(report), exitCode: 0 };\n}\n\nfunction buildDoctorReport(options: RegistryCommandOptions): DoctorReport {\n const bundledPath = defaultGeneratedRegistryPath();\n const bundled = loadBundledGeneratedRegistry(bundledPath);\n const overlay = loadCapabilityOverlay(options.overlayPath ?? process.env);\n const discovery = getCapabilityDiscovery();\n const fallback = discovery.getConservativeDefault();\n\n return {\n tierCounts: discovery.getTierCounts(),\n bundled: {\n path: bundledPath,\n present: bundled !== null,\n entryCount: bundled !== null ? bundled.entryCount : null,\n generatedAt: bundled !== null ? bundled.generatedAt : null,\n },\n overlay: {\n path: overlay.path,\n status: overlay.status,\n entryCount: overlay.entries.length,\n rejections: overlay.rejections.map((r) => ({\n index: r.index,\n ...(r.id !== undefined ? { id: r.id } : {}),\n reason: r.reason,\n })),\n envOverride: process.env[OVERLAY_ENV_VAR],\n },\n conservativeDefault: {\n contextWindow: fallback.contextWindow,\n maxOutputTokens: fallback.maxOutputTokens ?? null,\n },\n };\n}\n\nfunction formatDoctorReport(r: DoctorReport): string {\n const lines: string[] = [];\n lines.push('nexus-agents registry doctor');\n lines.push('============================');\n lines.push('');\n lines.push('Tier counts (T3 overlay → T1 canonical → T2 bundled → T4 fallback):');\n lines.push(` T3 overlay : ${String(r.tierCounts.t3)}`);\n lines.push(` T1 canonical : ${String(r.tierCounts.t1)}`);\n lines.push(` T2 bundled : ${String(r.tierCounts.t2)}`);\n lines.push('');\n lines.push('T2 bundled registry:');\n lines.push(` path : ${r.bundled.path}`);\n lines.push(` present : ${r.bundled.present ? 'yes' : 'no (using T1 + T4 only)'}`);\n if (r.bundled.present) {\n lines.push(` entryCount : ${String(r.bundled.entryCount ?? '?')}`);\n lines.push(` generatedAt : ${r.bundled.generatedAt ?? '?'}`);\n }\n lines.push('');\n lines.push('T3 user overlay:');\n lines.push(` path : ${r.overlay.path}`);\n lines.push(` status : ${r.overlay.status}`);\n lines.push(` entryCount : ${String(r.overlay.entryCount)}`);\n lines.push(` env override: ${r.overlay.envOverride ?? '(not set)'}`);\n if (r.overlay.rejections.length > 0) {\n lines.push(' rejections :');\n for (const rej of r.overlay.rejections) {\n const idPart = rej.id !== undefined ? ` id=${rej.id}` : '';\n lines.push(` - [${String(rej.index)}]${idPart} ${rej.reason}`);\n }\n }\n lines.push('');\n lines.push('T4 conservative default (for unknown ids):');\n lines.push(` contextWindow : ${String(r.conservativeDefault.contextWindow)}`);\n if (r.conservativeDefault.maxOutputTokens !== null) {\n lines.push(` maxOutputTokens: ${String(r.conservativeDefault.maxOutputTokens)}`);\n }\n return lines.join('\\n');\n}\n\n// ---------------------------------------------------------------------------\n// refresh\n// ---------------------------------------------------------------------------\n\nconst MAX_REFRESH_BYTES = 5 * 1024 * 1024;\n\nfunction missingSourceResult(): RegistryCommandResult {\n return {\n text: [\n 'registry refresh requires --source=<url>.',\n '',\n 'The url should point at a model-registry.generated.json file with a',\n 'matching <url>.sha256 sidecar (single line containing the SHA256 hash).',\n '',\n 'A signed GitHub release artifact is a planned default but not wired yet;',\n `that is tracked in #2180. Use --source=<your-mirror-url> in the meantime.`,\n ].join('\\n'),\n exitCode: 2,\n };\n}\n\ninterface VerifiedArtifact {\n readonly body: string;\n readonly sha256: string;\n}\n\nasync function fetchAndVerify(\n source: string,\n fetchImpl: typeof fetch\n): Promise<VerifiedArtifact | RegistryCommandResult> {\n const body = await fetchWithCap(source, fetchImpl);\n if (!body.ok || body.body === undefined) {\n return { text: `Failed to fetch ${source}: ${body.error ?? 'unknown'}`, exitCode: 1 };\n }\n const sha = await fetchWithCap(`${source}.sha256`, fetchImpl);\n if (!sha.ok || sha.body === undefined) {\n return {\n text: `Failed to fetch ${source}.sha256 for integrity check: ${sha.error ?? 'unknown'}`,\n exitCode: 1,\n };\n }\n const expected = sha.body.trim().split(/\\s+/)[0] ?? '';\n if (expected === '') {\n return { text: `SHA256 sidecar at ${source}.sha256 is empty`, exitCode: 1 };\n }\n const actual = createHash('sha256').update(body.body, 'utf-8').digest('hex');\n if (actual.toLowerCase() !== expected.toLowerCase()) {\n return {\n text: `SHA256 mismatch: expected ${expected}, got ${actual}. Aborting write.`,\n exitCode: 1,\n };\n }\n return { body: body.body, sha256: actual };\n}\n\nfunction formatRefreshReport(\n verb: 'would write to' | 'wrote to',\n source: string,\n artifact: VerifiedArtifact,\n dest: string,\n extraTail: readonly string[] = []\n): string {\n return [\n `registry refresh${verb.startsWith('would') ? ' --dry-run' : ''}`,\n `source : ${source}`,\n `sha256 : ${artifact.sha256} (verified)`,\n `bytes : ${String(artifact.body.length)}`,\n `${verb}: ${dest}`,\n ...extraTail,\n ].join('\\n');\n}\n\nasync function refreshCommand(options: RegistryCommandOptions): Promise<RegistryCommandResult> {\n const source = options.source;\n if (source === undefined || source === '') return missingSourceResult();\n\n const artifact = await fetchAndVerify(source, options.fetchImpl ?? fetch);\n if ('text' in artifact) return artifact;\n\n const dest = options.destPath ?? nexusDataPath('model-registry.generated.json');\n if (options.dryRun === true) {\n return { text: formatRefreshReport('would write to', source, artifact, dest), exitCode: 0 };\n }\n\n mkdirSync(dirname(dest), { recursive: true });\n writeFileSync(dest, artifact.body, 'utf-8');\n return {\n text: formatRefreshReport('wrote to', source, artifact, dest, [\n '',\n 'The refreshed file takes precedence over the bundled registry on the next',\n 'run. Restart any running CLI / MCP server for the change to take effect.',\n ]),\n exitCode: 0,\n };\n}\n\ninterface FetchResult {\n readonly ok: boolean;\n readonly body?: string;\n readonly error?: string;\n}\n\nasync function fetchWithCap(url: string, fetchImpl: typeof fetch): Promise<FetchResult> {\n try {\n const response = await fetchImpl(url, { signal: AbortSignal.timeout(30_000) });\n if (!response.ok) {\n return { ok: false, error: `HTTP ${String(response.status)}` };\n }\n const body = await response.text();\n if (body.length > MAX_REFRESH_BYTES) {\n return {\n ok: false,\n error: `payload ${String(body.length)} bytes exceeds cap ${String(MAX_REFRESH_BYTES)}`,\n };\n }\n return { ok: true, body };\n } catch (err: unknown) {\n const message = err instanceof Error ? err.message : String(err);\n return { ok: false, error: message };\n }\n}\n\n// ---------------------------------------------------------------------------\n// Usage\n// ---------------------------------------------------------------------------\n\nexport function formatRegistryUsage(): string {\n return [\n 'Usage:',\n ' nexus-agents registry doctor [--json]',\n ' Inspect the four-tier capability discovery state.',\n '',\n ' nexus-agents registry refresh --source=<url> [--dry-run]',\n ' Download a signed model-registry.generated.json from <url>,',\n ' SHA256-verify against <url>.sha256, and write to:',\n ` ${nexusDataPath('model-registry.generated.json')}`,\n '',\n `Overlay path (T3) is ${defaultOverlayPath()} by default,`,\n `or whatever ${OVERLAY_ENV_VAR} points to. Overlay max size is ${String(OVERLAY_MAX_BYTES)} bytes.`,\n ].join('\\n');\n}\n\n// Dummy references to satisfy unused-var lint when destructuring is conditional.\nvoid existsSync;\nvoid readFileSync;\nvoid resolveOverlayPath;\n","/**\n * CapabilityDiscovery — synchronous four-tier model capability resolution\n * for epic #2174 (child issue #2176).\n *\n * Lookup order: **T3 user YAML overlay → T1 hardcoded canonical → T2 bundled\n * generated → T4 conservative default**. User overlay wins so operators can\n * fix a broken bundled or canonical entry. No runtime network fetch — T2 is\n * loaded once from the bundled JSON (or skipped if the file is missing /\n * corrupt). Injection points exist for tests so no test ever touches the\n * real filesystem or network.\n *\n * This issue (#2176) only delivers the class + tests. Existing call sites\n * keep using the direct T1 helpers in `model-config-helpers.ts` (the\n * registry-backed surface that replaced the legacy `model-capabilities.ts`\n * after #2546 slice E) — those get migrated when #2177 flips the\n * conservative default from the legacy 200 K fall-through to fail-closed\n * 8 K, and when #2178 wires the T3 YAML loader in.\n *\n * @module config/capability-discovery\n */\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\nimport { z } from 'zod';\n\nimport type { ILogger } from '../core/index.js';\nimport { createLogger } from '../core/index.js';\nimport { getInTreeCapabilitiesMatrix } from './model-config-helpers.js';\nimport type {\n ModelCapabilitiesMatrix,\n ModelCapability,\n Pricing,\n} from './model-capabilities-types.js';\nimport { loadCapabilityOverlay } from './capability-overlay.js';\n\n// ---------------------------------------------------------------------------\n// Generated (T2) shape — mirrors scripts/build-model-registry-types.ts\n// ---------------------------------------------------------------------------\n\nconst GeneratedProvenanceSchema = z.object({\n source: z.enum(['models.dev', 'litellm']),\n fetchedAt: z.string(),\n upstreamUrl: z.string(),\n});\n\nexport type GeneratedProvenance = z.infer<typeof GeneratedProvenanceSchema>;\n\nconst GeneratedModelEntrySchema = z.object({\n id: z.string().min(1),\n displayName: z.string().min(1),\n provider: z.string().min(1),\n contextWindow: z.number().int().positive(),\n pricing: z\n .object({\n inputPer1M: z.number().nonnegative(),\n outputPer1M: z.number().nonnegative(),\n })\n .optional(),\n maxOutputTokens: z.number().int().positive().optional(),\n deprecated: z.boolean().optional(),\n provenance: GeneratedProvenanceSchema,\n});\n\nexport type GeneratedModelEntry = z.infer<typeof GeneratedModelEntrySchema>;\n\nconst GeneratedRegistrySchema = z.object({\n version: z.literal(1),\n generatedAt: z.string(),\n entryCount: z.number().int().nonnegative(),\n entries: z.array(GeneratedModelEntrySchema),\n});\n\nexport type GeneratedRegistry = z.infer<typeof GeneratedRegistrySchema>;\n\n// ---------------------------------------------------------------------------\n// T4 conservative-default toggles\n// ---------------------------------------------------------------------------\n\n/** Conservative default returned when no tier resolves a model id. */\nexport interface ConservativeDefault {\n readonly contextWindow: number;\n readonly maxOutputTokens?: number;\n}\n\n/**\n * Legacy default matching today's `getModelContextWindow` 200 K fall-through.\n * Preserved so this issue (#2176) is a pure addition. Issue #2177 will\n * switch the default to `FAIL_CLOSED_DEFAULT` and update the routing paths\n * to skip models resolved at T4.\n */\nexport const LEGACY_200K_DEFAULT: ConservativeDefault = { contextWindow: 200_000 };\n\n/** Fail-closed default that #2177 will flip on. */\nexport const FAIL_CLOSED_DEFAULT: ConservativeDefault = { contextWindow: 8_192 };\n\n// ---------------------------------------------------------------------------\n// ResolvedCapability — unified shape returned by resolve()\n// ---------------------------------------------------------------------------\n\nexport type ResolutionTier = 't1' | 't2' | 't3' | 't4';\n\nexport interface ResolvedCapability {\n readonly tier: ResolutionTier;\n readonly id: string;\n readonly displayName: string;\n readonly provider: string;\n readonly contextWindow: number;\n readonly pricing?: Pricing;\n readonly maxOutputTokens?: number;\n readonly deprecated?: boolean;\n /** Full T1/T3 entry when resolved from the canonical-shaped tiers. */\n readonly canonical?: ModelCapability;\n /** Provenance when resolved from T2. */\n readonly provenance?: GeneratedProvenance;\n}\n\n// ---------------------------------------------------------------------------\n// Config + construction\n// ---------------------------------------------------------------------------\n\nexport interface CapabilityDiscoveryConfig {\n /** T1 canonical registry. Defaults to the in-tree matrix from the ModelRegistry. */\n readonly canonical?: ModelCapabilitiesMatrix;\n /** T2 bundled generated registry. Pass `null` to force-skip T2. */\n readonly generated?: GeneratedRegistry | null;\n /** T3 user overlay entries. Defaults to empty. Loader is #2178. */\n readonly overlay?: readonly ModelCapability[];\n /** T4 fallback. Defaults to `LEGACY_200K_DEFAULT` until #2177 flips it. */\n readonly conservativeDefault?: ConservativeDefault;\n /** Logger; defaults to a named logger. Inject a mock in tests. */\n readonly logger?: ILogger;\n}\n\nexport class CapabilityDiscovery {\n private readonly canonical: ModelCapabilitiesMatrix;\n private readonly generated: GeneratedRegistry | null;\n private readonly overlay: readonly ModelCapability[];\n private readonly fallback: ConservativeDefault;\n private readonly logger: ILogger;\n private readonly generatedById: Map<string, GeneratedModelEntry>;\n\n constructor(config: CapabilityDiscoveryConfig = {}) {\n // The helper returns a readonly view; loosen here because\n // `ModelCapabilitiesMatrix` predates the registry and uses mutable\n // arrays. Callers in this class only read.\n this.canonical = config.canonical ?? (getInTreeCapabilitiesMatrix() as ModelCapabilitiesMatrix);\n this.generated = config.generated ?? null;\n this.overlay = config.overlay ?? [];\n this.fallback = config.conservativeDefault ?? LEGACY_200K_DEFAULT;\n this.logger = config.logger ?? createLogger({ component: 'capability-discovery' });\n\n this.generatedById = new Map();\n if (this.generated !== null) {\n for (const entry of this.generated.entries) {\n this.generatedById.set(entry.id, entry);\n }\n }\n }\n\n /** Synchronously resolve a model id through the four-tier chain. */\n resolve(modelId: string): ResolvedCapability {\n const t3 = this.lookupOverlay(modelId);\n if (t3 !== undefined) return this.fromCanonical('t3', t3);\n\n const t1 = this.lookupCanonical(modelId);\n if (t1 !== undefined) return this.fromCanonical('t1', t1);\n\n const t2 = this.lookupGenerated(modelId);\n if (t2 !== undefined) return this.fromGenerated('t2', t2);\n\n return this.fromFallback(modelId);\n }\n\n /** Exposes the configured fallback for testing / doctor command. */\n getConservativeDefault(): ConservativeDefault {\n return this.fallback;\n }\n\n /** Count of entries per tier — used by `registry doctor` (#2179). */\n getTierCounts(): Record<ResolutionTier, number> {\n return {\n t3: this.overlay.length,\n t1: this.canonical.models.length,\n t2: this.generatedById.size,\n t4: 0,\n };\n }\n\n // -------------------------------------------------------------------------\n // Tier lookups\n // -------------------------------------------------------------------------\n\n private lookupOverlay(modelId: string): ModelCapability | undefined {\n return this.overlay.find((m) => m.id === modelId);\n }\n\n private lookupCanonical(modelId: string): ModelCapability | undefined {\n return this.canonical.models.find((m) => m.id === modelId);\n }\n\n private lookupGenerated(modelId: string): GeneratedModelEntry | undefined {\n const direct = this.generatedById.get(modelId);\n if (direct !== undefined) return direct;\n for (const candidate of buildAliasCandidates(modelId)) {\n const hit = this.generatedById.get(candidate);\n if (hit !== undefined) return hit;\n }\n return undefined;\n }\n\n // -------------------------------------------------------------------------\n // Result shaping\n // -------------------------------------------------------------------------\n\n private fromCanonical(tier: 't1' | 't3', entry: ModelCapability): ResolvedCapability {\n const base: ResolvedCapability = {\n tier,\n id: entry.id,\n displayName: entry.displayName,\n provider: entry.provider,\n contextWindow: entry.contextWindow,\n canonical: entry,\n ...(entry.pricing !== undefined ? { pricing: entry.pricing } : {}),\n ...(entry.maxOutputTokens !== undefined ? { maxOutputTokens: entry.maxOutputTokens } : {}),\n ...(entry.deprecated !== undefined ? { deprecated: entry.deprecated } : {}),\n };\n return base;\n }\n\n private fromGenerated(tier: 't2', entry: GeneratedModelEntry): ResolvedCapability {\n return {\n tier,\n id: entry.id,\n displayName: entry.displayName,\n provider: entry.provider,\n contextWindow: entry.contextWindow,\n provenance: entry.provenance,\n ...(entry.pricing !== undefined ? { pricing: entry.pricing } : {}),\n ...(entry.maxOutputTokens !== undefined ? { maxOutputTokens: entry.maxOutputTokens } : {}),\n ...(entry.deprecated !== undefined ? { deprecated: entry.deprecated } : {}),\n };\n }\n\n private fromFallback(modelId: string): ResolvedCapability {\n this.logger.warn('Model resolved at T4 conservative default', {\n modelId,\n contextWindow: this.fallback.contextWindow,\n });\n return {\n tier: 't4',\n id: modelId,\n displayName: modelId,\n provider: 'unknown',\n contextWindow: this.fallback.contextWindow,\n ...(this.fallback.maxOutputTokens !== undefined\n ? { maxOutputTokens: this.fallback.maxOutputTokens }\n : {}),\n };\n }\n}\n\n// ---------------------------------------------------------------------------\n// Alias resolution helpers\n// ---------------------------------------------------------------------------\n\nconst KNOWN_PROVIDER_PREFIXES: readonly string[] = [\n 'amazon-bedrock',\n 'google-vertex',\n 'azure-openai',\n 'openrouter',\n 'anthropic',\n 'openai',\n 'google',\n 'deepseek',\n];\n\n/**\n * Generate candidate alias forms so versioned / prefix-stripped ids still\n * resolve to their T2 entry. Example inputs:\n * anthropic.claude-3-5-sonnet-20241022-v2:0\n * openrouter/anthropic/claude-3-5-sonnet\n * gpt-5-codex\n */\nexport function buildAliasCandidates(modelId: string): readonly string[] {\n const seen = new Set<string>([modelId]);\n for (const prefix of KNOWN_PROVIDER_PREFIXES) {\n seen.add(`${prefix}/${modelId}`);\n }\n const slash = modelId.indexOf('/');\n if (slash !== -1) {\n const tail = modelId.slice(slash + 1);\n for (const prefix of KNOWN_PROVIDER_PREFIXES) {\n seen.add(`${prefix}/${tail}`);\n }\n }\n seen.delete(modelId);\n return [...seen];\n}\n\n// ---------------------------------------------------------------------------\n// Bundled T2 loader — used by the global singleton only, injectable for tests\n// ---------------------------------------------------------------------------\n\n/** Path to the bundled generated registry. Test-only export. */\nexport function defaultGeneratedRegistryPath(): string {\n const here = dirname(fileURLToPath(import.meta.url));\n return join(here, 'model-registry.generated.json');\n}\n\n/**\n * Loads the bundled T2 registry synchronously. Returns `null` if the file\n * is missing or fails Zod validation — callers should treat null as \"T2\n * unavailable\" and fall through to T1 + T4. Logs but never throws.\n */\nexport function loadBundledGeneratedRegistry(\n path: string = defaultGeneratedRegistryPath(),\n logger?: ILogger\n): GeneratedRegistry | null {\n const log = logger ?? createLogger({ component: 'capability-discovery' });\n if (!existsSync(path)) {\n log.warn('T2 generated registry file missing; falling back to T1 + T4', { path });\n return null;\n }\n let raw: unknown;\n try {\n raw = JSON.parse(readFileSync(path, 'utf-8'));\n } catch (err: unknown) {\n const error = err instanceof Error ? err : new Error(String(err));\n log.warn('T2 generated registry JSON parse failed; falling back to T1 + T4', {\n path,\n errorMessage: error.message,\n });\n return null;\n }\n const parsed = GeneratedRegistrySchema.safeParse(raw);\n if (!parsed.success) {\n log.warn('T2 generated registry schema validation failed; falling back to T1 + T4', {\n path,\n errorMessage: parsed.error.message,\n });\n return null;\n }\n return parsed.data;\n}\n\n// ---------------------------------------------------------------------------\n// Global singleton\n// ---------------------------------------------------------------------------\n\nlet globalDiscovery: CapabilityDiscovery | undefined;\n\n/**\n * Global singleton. Lazily constructed on first access using the bundled T2\n * registry + canonical T1. Tests MUST call `setCapabilityDiscovery` with an\n * injected instance to avoid touching the real file.\n */\nexport function getCapabilityDiscovery(): CapabilityDiscovery {\n globalDiscovery ??= new CapabilityDiscovery({\n generated: loadBundledGeneratedRegistry(),\n overlay: loadCapabilityOverlay().entries,\n // Fail-closed default (#2177): unknown models get 8 K context and a\n // structured warn instead of the silent 200 K fall-through the legacy\n // getModelContextWindow used to return.\n conservativeDefault: FAIL_CLOSED_DEFAULT,\n });\n return globalDiscovery;\n}\n\n/** Test-only: inject a discovery instance. */\nexport function setCapabilityDiscovery(discovery: CapabilityDiscovery | undefined): void {\n globalDiscovery = discovery;\n}\n","/**\n * User YAML overlay loader for CapabilityDiscovery's T3 tier (#2178).\n *\n * Reads user-supplied model capability overrides from a YAML file. Fully\n * optional — missing file, empty file, malformed YAML, and schema-invalid\n * entries all return the empty overlay with structured warnings instead of\n * throwing. Operators use this to fix broken bundled / canonical entries\n * without needing an npm release, or to declare models the curated T1 /\n * generated T2 tiers don't cover.\n *\n * Precedent: LiteLLM's `register_model({...})` + aider's\n * `aider/resources/model-settings.yml`.\n *\n * @module config/capability-overlay\n */\n\nimport { existsSync, readFileSync, statSync } from 'node:fs';\nimport { parse as parseYaml } from 'yaml';\nimport { nexusDataPath } from './nexus-data-dir.js';\n\nimport type { ILogger } from '../core/index.js';\nimport { createLogger } from '../core/index.js';\nimport { ModelCapabilitySchema } from './model-capabilities-types.js';\nimport type { ModelCapability } from './model-capabilities-types.js';\n\n/** Environment variable an operator can set to override the default path. */\nexport const OVERLAY_ENV_VAR = 'NEXUS_MODEL_REGISTRY_OVERLAY';\n\n/** Max file size accepted for the overlay (1 MB — far larger than expected). */\nexport const OVERLAY_MAX_BYTES = 1 * 1024 * 1024;\n\n/**\n * Default overlay location: `<NEXUS_DATA_DIR>/models.yaml`. Returns the\n * absolute path without checking if it exists.\n */\nexport function defaultOverlayPath(): string {\n return nexusDataPath('models.yaml');\n}\n\n/**\n * Resolves the overlay path: `$NEXUS_MODEL_REGISTRY_OVERLAY` wins if set,\n * otherwise the default `~/.nexus-agents/models.yaml`.\n */\nexport function resolveOverlayPath(env: NodeJS.ProcessEnv = process.env): string {\n const override = env[OVERLAY_ENV_VAR];\n if (override !== undefined && override !== '') return override;\n return defaultOverlayPath();\n}\n\n// ---------------------------------------------------------------------------\n// Result shape\n// ---------------------------------------------------------------------------\n\n/** Structured reason for a rejected or skipped entry. */\nexport interface OverlayRejection {\n readonly index: number;\n readonly id?: string;\n readonly reason: string;\n}\n\nexport interface OverlayLoadResult {\n readonly entries: readonly ModelCapability[];\n readonly rejections: readonly OverlayRejection[];\n readonly path: string;\n readonly status: 'missing' | 'empty' | 'malformed' | 'too-large' | 'loaded';\n}\n\n// ---------------------------------------------------------------------------\n// Loader\n// ---------------------------------------------------------------------------\n\n/**\n * Expected YAML root shape:\n *\n * version: 1\n * models:\n * - id: claude-opus\n * displayName: \"Claude Opus (overridden)\"\n * provider: anthropic\n * contextWindow: 1000000\n * ...\n * - ...\n *\n * or simply:\n *\n * - id: ...\n * ...\n *\n * Both a top-level array and an object with `models:` are accepted for\n * ergonomics; everything else is rejected with a structured reason.\n */\nexport function loadCapabilityOverlay(\n pathOrEnv?: string | NodeJS.ProcessEnv,\n logger?: ILogger\n): OverlayLoadResult {\n const log = logger ?? createLogger({ component: 'capability-overlay' });\n const path = resolvePath(pathOrEnv);\n\n if (!existsSync(path)) {\n return { entries: [], rejections: [], path, status: 'missing' };\n }\n\n const sizeStatus = checkSize(path, log);\n if (sizeStatus !== undefined) return sizeStatus;\n\n const bodyResult = readBody(path, log);\n if ('result' in bodyResult) return bodyResult.result;\n const body = bodyResult.body;\n if (body === '') {\n log.info('Model registry overlay file is empty', { path });\n return { entries: [], rejections: [], path, status: 'empty' };\n }\n\n const parseResult = parseBody(body, path, log);\n if ('result' in parseResult) return parseResult.result;\n const parsed = parseResult.parsed;\n\n const rawEntries = extractEntries(parsed);\n if (rawEntries === undefined) {\n log.warn('Model registry overlay has unrecognized shape; treated as empty', {\n path,\n });\n return {\n entries: [],\n rejections: [{ index: -1, reason: 'Expected array or { models: [...] }' }],\n path,\n status: 'malformed',\n };\n }\n\n const { entries, rejections } = validateEntries(rawEntries, log, path);\n return { entries, rejections, path, status: 'loaded' };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction resolvePath(pathOrEnv: string | NodeJS.ProcessEnv | undefined): string {\n if (typeof pathOrEnv === 'string') return pathOrEnv;\n if (pathOrEnv !== undefined) return resolveOverlayPath(pathOrEnv);\n return resolveOverlayPath();\n}\n\ntype ReadBodyResult = { body: string } | { result: OverlayLoadResult };\nfunction readBody(path: string, log: ILogger): ReadBodyResult {\n try {\n return { body: readFileSync(path, 'utf-8').trim() };\n } catch (err: unknown) {\n const message = err instanceof Error ? err.message : String(err);\n log.warn('Model registry overlay file read failed; treated as empty', {\n path,\n errorMessage: message,\n });\n return {\n result: {\n entries: [],\n rejections: [{ index: -1, reason: `file read error: ${message}` }],\n path,\n status: 'malformed',\n },\n };\n }\n}\n\ntype ParseBodyResult = { parsed: unknown } | { result: OverlayLoadResult };\nfunction parseBody(body: string, path: string, log: ILogger): ParseBodyResult {\n try {\n return { parsed: parseYaml(body) };\n } catch (err: unknown) {\n const message = err instanceof Error ? err.message : String(err);\n log.warn('Model registry overlay YAML parse failed; treated as empty', {\n path,\n errorMessage: message,\n });\n return {\n result: {\n entries: [],\n rejections: [{ index: -1, reason: `YAML parse error: ${message}` }],\n path,\n status: 'malformed',\n },\n };\n }\n}\n\nfunction checkSize(path: string, log: ILogger): OverlayLoadResult | undefined {\n let size: number;\n try {\n size = statSync(path).size;\n } catch (err: unknown) {\n const message = err instanceof Error ? err.message : String(err);\n log.warn('Model registry overlay statSync failed; treated as missing', {\n path,\n errorMessage: message,\n });\n return { entries: [], rejections: [], path, status: 'missing' };\n }\n if (size <= OVERLAY_MAX_BYTES) return undefined;\n log.warn('Model registry overlay exceeds size cap; refusing to load', {\n path,\n size,\n maxBytes: OVERLAY_MAX_BYTES,\n });\n return {\n entries: [],\n rejections: [\n {\n index: -1,\n reason: `file size ${String(size)} exceeds cap ${String(OVERLAY_MAX_BYTES)}`,\n },\n ],\n path,\n status: 'too-large',\n };\n}\n\nfunction extractIdForError(raw: unknown): string | undefined {\n if (raw === null || typeof raw !== 'object' || !('id' in raw)) return undefined;\n const idValue = raw.id;\n if (typeof idValue === 'string' && idValue !== '') return idValue;\n return undefined;\n}\n\nfunction extractEntries(parsed: unknown): unknown[] | undefined {\n if (Array.isArray(parsed)) return parsed as unknown[];\n if (parsed !== null && typeof parsed === 'object') {\n const obj = parsed as { models?: unknown };\n if (Array.isArray(obj.models)) return obj.models as unknown[];\n }\n return undefined;\n}\n\ninterface ValidatedEntries {\n readonly entries: readonly ModelCapability[];\n readonly rejections: readonly OverlayRejection[];\n}\n\nfunction validateEntries(\n rawEntries: readonly unknown[],\n log: ILogger,\n path: string\n): ValidatedEntries {\n const entries: ModelCapability[] = [];\n const rejections: OverlayRejection[] = [];\n for (let i = 0; i < rawEntries.length; i++) {\n const raw = rawEntries[i];\n const idCandidate = extractIdForError(raw);\n const parsed = ModelCapabilitySchema.safeParse(raw);\n if (!parsed.success) {\n const rejection: OverlayRejection = {\n index: i,\n ...(idCandidate !== undefined && idCandidate !== '' ? { id: idCandidate } : {}),\n reason: parsed.error.message,\n };\n rejections.push(rejection);\n log.warn('Model registry overlay entry rejected by schema', {\n path,\n index: i,\n id: idCandidate,\n errorMessage: parsed.error.message,\n });\n continue;\n }\n entries.push(parsed.data);\n }\n return { entries, rejections };\n}\n"],"mappings":"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","names":["existsSync","readFileSync","dirname","readFileSync","existsSync","existsSync","readFileSync","dirname"]}
@@ -3,9 +3,9 @@ import {
3
3
  buildPlanFromAnalysis,
4
4
  generateSecurityPlan,
5
5
  resolveScannerData
6
- } from "./chunk-L6N2S3UB.js";
6
+ } from "./chunk-CCODJRS6.js";
7
7
  import "./chunk-BC3M4VLP.js";
8
- import "./chunk-O4KUCF5S.js";
8
+ import "./chunk-Q3RFPJYK.js";
9
9
  import "./chunk-I7ORMAO7.js";
10
10
  import "./chunk-GOT7OAL5.js";
11
11
  import "./chunk-UP2VWCW5.js";
@@ -15,4 +15,4 @@ export {
15
15
  generateSecurityPlan,
16
16
  resolveScannerData
17
17
  };
18
- //# sourceMappingURL=repo-security-plan-3J45VAD6.js.map
18
+ //# sourceMappingURL=repo-security-plan-W35CXK3T.js.map
@@ -1,12 +1,12 @@
1
1
  import {
2
2
  synthesizeResearch
3
- } from "./chunk-A35XORXU.js";
3
+ } from "./chunk-Q7FTNKPO.js";
4
4
  import "./chunk-NUBSJGQZ.js";
5
- import "./chunk-O4KUCF5S.js";
5
+ import "./chunk-Q3RFPJYK.js";
6
6
  import "./chunk-I7ORMAO7.js";
7
7
  import "./chunk-GOT7OAL5.js";
8
8
  import "./chunk-UP2VWCW5.js";
9
9
  export {
10
10
  synthesizeResearch
11
11
  };
12
- //# sourceMappingURL=research-helpers-synthesize-UGQHZZJN.js.map
12
+ //# sourceMappingURL=research-helpers-synthesize-GUQORWL4.js.map
@@ -2,7 +2,7 @@ import {
2
2
  DEFAULT_ROUTING_MEMORY_CONFIG,
3
3
  RoutingMemory,
4
4
  createRoutingMemory
5
- } from "./chunk-O4KUCF5S.js";
5
+ } from "./chunk-Q3RFPJYK.js";
6
6
  import "./chunk-I7ORMAO7.js";
7
7
  import "./chunk-GOT7OAL5.js";
8
8
  import "./chunk-UP2VWCW5.js";
@@ -11,4 +11,4 @@ export {
11
11
  RoutingMemory,
12
12
  createRoutingMemory
13
13
  };
14
- //# sourceMappingURL=routing-memory-NO7QEH7T.js.map
14
+ //# sourceMappingURL=routing-memory-VOJBOX3X.js.map
@@ -6,8 +6,8 @@ import {
6
6
  SessionMemory,
7
7
  SessionMemoryError,
8
8
  createSessionMemory
9
- } from "./chunk-2KB63QGE.js";
10
- import "./chunk-O4KUCF5S.js";
9
+ } from "./chunk-EQHYXT56.js";
10
+ import "./chunk-Q3RFPJYK.js";
11
11
  import "./chunk-I7ORMAO7.js";
12
12
  import "./chunk-GOT7OAL5.js";
13
13
  import "./chunk-UP2VWCW5.js";
@@ -20,4 +20,4 @@ export {
20
20
  SessionMemoryError,
21
21
  createSessionMemory
22
22
  };
23
- //# sourceMappingURL=session-memory-DOXLEWEU.js.map
23
+ //# sourceMappingURL=session-memory-B6LQMF4N.js.map
@@ -7,16 +7,17 @@ import {
7
7
  runWizard,
8
8
  setupCommand,
9
9
  setupCommandAsync
10
- } from "./chunk-C3JGKBL2.js";
11
- import "./chunk-DA5UDQYW.js";
12
- import "./chunk-YOREAPF6.js";
13
- import "./chunk-2MD5MWCK.js";
10
+ } from "./chunk-65R32U3M.js";
11
+ import "./chunk-DGELGUZF.js";
12
+ import "./chunk-WCCTIRSB.js";
13
+ import "./chunk-QON7LR7J.js";
14
+ import "./chunk-GS3GW7C7.js";
14
15
  import "./chunk-NUBSJGQZ.js";
15
- import "./chunk-ES6GFP35.js";
16
+ import "./chunk-NC2LECY6.js";
16
17
  import "./chunk-ZM4O442V.js";
17
18
  import "./chunk-633WH2ML.js";
18
- import "./chunk-TQFRPFMG.js";
19
- import "./chunk-O4KUCF5S.js";
19
+ import "./chunk-TBRNRW2Q.js";
20
+ import "./chunk-Q3RFPJYK.js";
20
21
  import "./chunk-I7ORMAO7.js";
21
22
  import "./chunk-GOT7OAL5.js";
22
23
  import "./chunk-UP2VWCW5.js";
@@ -30,4 +31,4 @@ export {
30
31
  setupCommand,
31
32
  setupCommandAsync
32
33
  };
33
- //# sourceMappingURL=setup-command-BWUFMZ7U.js.map
34
+ //# sourceMappingURL=setup-command-CTC5YNA4.js.map
@@ -1,11 +1,11 @@
1
1
  import {
2
2
  runConfigInitSync
3
- } from "./chunk-DA5UDQYW.js";
4
- import "./chunk-O4KUCF5S.js";
3
+ } from "./chunk-DGELGUZF.js";
4
+ import "./chunk-Q3RFPJYK.js";
5
5
  import "./chunk-I7ORMAO7.js";
6
6
  import "./chunk-GOT7OAL5.js";
7
7
  import "./chunk-UP2VWCW5.js";
8
8
  export {
9
9
  runConfigInitSync
10
10
  };
11
- //# sourceMappingURL=setup-config-E3JZYSLR.js.map
11
+ //# sourceMappingURL=setup-config-53MHJA7S.js.map
@@ -2,14 +2,14 @@ import {
2
2
  CUSTOM_API_ALLOW_PRIVATE_ENV,
3
3
  CUSTOM_API_BASE_URL_ENV,
4
4
  validateCustomApiBaseUrl
5
- } from "./chunk-5WQ3SRSE.js";
5
+ } from "./chunk-PAFH336F.js";
6
6
  import {
7
7
  CUSTOM_API_DEFAULT_MODEL
8
- } from "./chunk-2MD5MWCK.js";
8
+ } from "./chunk-GS3GW7C7.js";
9
9
  import {
10
10
  err,
11
11
  ok
12
- } from "./chunk-O4KUCF5S.js";
12
+ } from "./chunk-Q3RFPJYK.js";
13
13
  import "./chunk-I7ORMAO7.js";
14
14
  import "./chunk-GOT7OAL5.js";
15
15
  import "./chunk-UP2VWCW5.js";
@@ -107,4 +107,4 @@ function buildShellFragment(params) {
107
107
  export {
108
108
  configureCustomApi
109
109
  };
110
- //# sourceMappingURL=setup-custom-api-DHJ5DRH2.js.map
110
+ //# sourceMappingURL=setup-custom-api-VD5W754A.js.map
@@ -3,7 +3,7 @@ import {
3
3
  getAdaptiveBonus,
4
4
  queryWithLookback,
5
5
  shouldExplore
6
- } from "./chunk-O4KUCF5S.js";
6
+ } from "./chunk-Q3RFPJYK.js";
7
7
  import "./chunk-I7ORMAO7.js";
8
8
  import "./chunk-GOT7OAL5.js";
9
9
  import "./chunk-UP2VWCW5.js";
@@ -13,4 +13,4 @@ export {
13
13
  queryWithLookback,
14
14
  shouldExplore
15
15
  };
16
- //# sourceMappingURL=weather-report-FNN4OX3N.js.map
16
+ //# sourceMappingURL=weather-report-APASTJDQ.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexus-agents",
3
- "version": "2.72.1",
3
+ "version": "2.74.0",
4
4
  "description": "Intelligent orchestration platform for AI coding tools — routes tasks to the best model, learns from outcomes, and enforces quality through multi-model consensus",
5
5
  "mcpName": "io.github.williamzujkowski/nexus-agents",
6
6
  "license": "MIT",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/scm/types.ts","../src/scm/github-provider.ts"],"sourcesContent":["/**\n * nexus-agents/scm - SCM Provider Types\n *\n * Shared types for the centralized SCM (Source Control Management) module.\n * Supports GitHub (REST API + gh CLI) with extensibility for GitLab/Gitea.\n *\n * @module scm/types\n * (Source: Issue #1136 — Centralized SCM Provider Module)\n */\n\nimport type { Result } from '../core/index.js';\n\n// ============================================================================\n// Token Types\n// ============================================================================\n\n/** Supported SCM platforms. */\nexport type ScmPlatform = 'github' | 'gitlab' | 'gitea';\n\n/** Token resolution strategy. */\nexport type TokenStrategy = 'env' | 'cli' | 'config';\n\n/** Resolved SCM token with metadata. */\nexport interface ScmToken {\n /** The raw token value */\n readonly value: string;\n /** How the token was resolved */\n readonly strategy: TokenStrategy;\n /** SCM platform this token is for */\n readonly platform: ScmPlatform;\n}\n\n/** Token resolution configuration. */\nexport interface TokenResolverConfig {\n /** Explicit token (highest priority) */\n readonly token?: string;\n /** SCM platform to resolve for */\n readonly platform?: ScmPlatform;\n /** Custom env var name override */\n readonly envVar?: string;\n}\n\n// ============================================================================\n// SCM Entity Types\n// ============================================================================\n\n/** SCM issue representation. */\nexport interface ScmIssue {\n readonly number: number;\n readonly title: string;\n readonly body: string;\n readonly labels: readonly string[];\n readonly author: string;\n readonly createdAt: string;\n}\n\n/** SCM pull/merge request representation. */\nexport interface ScmPullRequest {\n readonly number: number;\n readonly title: string;\n readonly body: string;\n readonly author: string;\n readonly base: string;\n readonly head: string;\n readonly url: string;\n}\n\n/** SCM comment representation. */\nexport interface ScmComment {\n readonly id: number;\n readonly body: string;\n readonly author: string;\n readonly createdAt: string;\n}\n\n/** PR creation options. */\nexport interface CreatePROptions {\n readonly title: string;\n readonly body: string;\n readonly head: string;\n readonly base: string;\n}\n\n/** PR merge options. */\nexport interface MergePROptions {\n readonly method?: 'merge' | 'squash' | 'rebase';\n readonly commitTitle?: string;\n readonly commitMessage?: string;\n readonly deleteBranch?: boolean;\n}\n\n/** PR status for merge eligibility. */\nexport interface PRStatus {\n readonly mergeable: boolean;\n readonly checksStatus: 'pending' | 'success' | 'failure';\n readonly reviewStatus: 'approved' | 'pending' | 'changes_requested';\n}\n\n/** Issue filter options. */\nexport interface IssueFilters {\n readonly labels?: readonly string[];\n readonly state?: 'open' | 'closed' | 'all';\n readonly limit?: number;\n}\n\n// ============================================================================\n// SCM Error\n// ============================================================================\n\n/** Unified SCM error with platform-aware context. */\nexport class ScmError extends Error {\n constructor(\n message: string,\n readonly platform: ScmPlatform,\n readonly statusCode?: number,\n readonly context?: Record<string, unknown>\n ) {\n super(message);\n this.name = 'ScmError';\n }\n}\n\n// ============================================================================\n// Extended Entity Types (Trait support)\n// ============================================================================\n\n/** File change in a pull request. */\nexport interface ScmFileChange {\n readonly filename: string;\n readonly status: 'added' | 'removed' | 'modified' | 'renamed' | 'copied';\n readonly additions: number;\n readonly deletions: number;\n readonly patch?: string;\n readonly previousFilename?: string;\n}\n\n/** Extended PR with file diffs and stats. Used by IScmReviewer. */\nexport interface ScmPullRequestDetail extends ScmPullRequest {\n readonly draft: boolean;\n readonly authorAssociation: string;\n readonly labels: readonly string[];\n readonly files: readonly ScmFileChange[];\n readonly additions: number;\n readonly deletions: number;\n readonly headSha: string;\n}\n\n/** Extended issue with association and state. Used by IScmReviewer. */\nexport interface ScmIssueDetail extends ScmIssue {\n readonly authorAssociation: string;\n readonly state: string;\n readonly url: string;\n}\n\n/** Extended comment with author association. */\nexport interface ScmCommentDetail extends ScmComment {\n readonly authorAssociation: string;\n}\n\n/** Review decision for a pull request. */\nexport type ScmReviewDecision = 'approve' | 'request_changes' | 'comment';\n\n/** User metadata for reputation assessment. */\nexport interface ScmUserMetadata {\n readonly login: string;\n readonly name: string | null;\n readonly company: string | null;\n readonly followers: number;\n readonly following: number;\n readonly publicRepos: number;\n readonly createdAt: string;\n}\n\n// ============================================================================\n// Provider Interface (Core)\n// ============================================================================\n\n/**\n * Core SCM provider interface.\n *\n * All methods return `Result<T, ScmError>` for consistent error handling\n * across GitHub REST API, gh CLI, and future GitLab/Gitea backends.\n */\nexport interface IScmProvider {\n /** Platform identifier. */\n readonly platform: ScmPlatform;\n\n /** Repository in owner/repo format. */\n readonly repo: string;\n\n // Issues\n getIssue(number: number): Promise<Result<ScmIssue, ScmError>>;\n listIssues(filters?: IssueFilters): Promise<Result<readonly ScmIssue[], ScmError>>;\n createIssue(\n title: string,\n body: string,\n labels?: readonly string[]\n ): Promise<Result<ScmIssue, ScmError>>;\n addLabels(issueNumber: number, labels: readonly string[]): Promise<Result<void, ScmError>>;\n\n // Pull Requests\n createPR(options: CreatePROptions): Promise<Result<ScmPullRequest, ScmError>>;\n mergePR(prNumber: number, options?: MergePROptions): Promise<Result<void, ScmError>>;\n getPRStatus(prNumber: number): Promise<Result<PRStatus, ScmError>>;\n\n // Comments\n addComment(issueNumber: number, body: string): Promise<Result<void, ScmError>>;\n listComments(issueNumber: number): Promise<Result<readonly ScmComment[], ScmError>>;\n}\n\n// ============================================================================\n// Trait Interfaces (ISP — Interface Segregation Principle)\n// ============================================================================\n\n/**\n * Review trait — PR review capabilities.\n *\n * Implemented by platforms supporting code review workflows.\n * Consumers declare this trait when they need PR file diffs or review posting.\n */\nexport interface IScmReviewer {\n /** Fetch PR with full file diffs and stats. */\n getPullRequestDetail(prNumber: number): Promise<Result<ScmPullRequestDetail, ScmError>>;\n\n /** Post a review on a pull request. */\n createReview(\n prNumber: number,\n body: string,\n decision: ScmReviewDecision\n ): Promise<Result<void, ScmError>>;\n\n /** Fetch issue with author association and state. */\n getIssueDetail(issueNumber: number): Promise<Result<ScmIssueDetail, ScmError>>;\n\n /** List comments with author associations. */\n listCommentDetails(issueNumber: number): Promise<Result<readonly ScmCommentDetail[], ScmError>>;\n}\n\n/**\n * User info trait — user metadata for reputation assessment.\n *\n * Implemented by platforms supporting user profile queries.\n * Consumers declare this trait when they need author reputation data.\n */\nexport interface IScmUserInfo {\n /** Fetch user metadata for reputation assessment. */\n fetchUserMetadata(username: string): Promise<Result<ScmUserMetadata, ScmError>>;\n}\n\n/**\n * Convenience type: provider with review capabilities.\n * Used by PR review workflows.\n */\nexport type ReviewCapableProvider = IScmProvider & IScmReviewer;\n\n/**\n * Convenience type: provider with all capabilities.\n * Used by full triage workflows that need review + user info.\n */\nexport type FullCapableProvider = IScmProvider & IScmReviewer & IScmUserInfo;\n","/**\n * nexus-agents/scm - GitHub Provider\n *\n * Unified GitHub provider using gh CLI. Implements IScmProvider with\n * Result-based error handling. Consolidates the two previous GitHub\n * clients (dogfooding/github-client.ts; the self-development one was deleted in #2402).\n *\n * @module scm/github-provider\n * (Source: Issue #1136 — Centralized SCM Provider Module)\n */\n\nimport { execFile } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { Result } from '../core/index.js';\nimport { ok, err, createLogger, getErrorMessage } from '../core/index.js';\nimport type {\n IScmProvider,\n ScmIssue,\n ScmPullRequest,\n ScmComment,\n CreatePROptions,\n MergePROptions,\n PRStatus,\n IssueFilters,\n} from './types.js';\nimport { ScmError } from './types.js';\n\nconst execFileAsync = promisify(execFile);\nconst logger = createLogger({ component: 'GitHubProvider' });\n\n/** Max buffer for gh CLI output (10MB). */\nconst MAX_BUFFER = 10 * 1024 * 1024;\n\n/** gh CLI timeout in ms. */\nconst GH_TIMEOUT_MS = 30_000;\n\n// ============================================================================\n// gh CLI JSON types (internal)\n// ============================================================================\n\ninterface GhIssueJson {\n number: number;\n title: string;\n body: string | null;\n labels: Array<{ name: string }>;\n author: { login: string };\n createdAt: string;\n}\n\ninterface GhCommentJson {\n id: number;\n body: string;\n author: { login: string };\n createdAt: string;\n}\n\ninterface GhPrJson {\n number: number;\n title: string;\n body: string | null;\n url: string;\n author: { login: string };\n baseRefName: string;\n headRefName: string;\n}\n\ninterface GhPrStatusJson {\n mergeable: string;\n statusCheckRollup: Array<{ state: string }> | null;\n reviewDecision: string | null;\n}\n\n// ============================================================================\n// gh CLI executor\n// ============================================================================\n\nasync function execGh(args: readonly string[], repo: string): Promise<Result<string, ScmError>> {\n const fullArgs = [...args, '--repo', repo];\n\n try {\n const { stdout } = await execFileAsync('gh', fullArgs, {\n maxBuffer: MAX_BUFFER,\n timeout: GH_TIMEOUT_MS,\n });\n return ok(stdout.trim());\n } catch (error) {\n const execError = error as { message: string; stderr?: string };\n return err(\n new ScmError(`gh command failed: ${execError.message}`, 'github', undefined, {\n command: `gh ${fullArgs.join(' ')}`,\n stderr: execError.stderr,\n })\n );\n }\n}\n\n// ============================================================================\n// Mappers\n// ============================================================================\n\nfunction mapIssue(raw: GhIssueJson): ScmIssue {\n return {\n number: raw.number,\n title: raw.title,\n body: raw.body ?? '',\n labels: raw.labels.map((l) => l.name),\n author: raw.author.login,\n createdAt: raw.createdAt,\n };\n}\n\nfunction mapComment(raw: GhCommentJson): ScmComment {\n return {\n id: raw.id,\n body: raw.body,\n author: raw.author.login,\n createdAt: raw.createdAt,\n };\n}\n\nfunction mapPRStatus(raw: GhPrStatusJson): PRStatus {\n const mergeable = raw.mergeable === 'MERGEABLE';\n\n let checksStatus: 'pending' | 'success' | 'failure' = 'pending';\n if (raw.statusCheckRollup !== null && raw.statusCheckRollup.length > 0) {\n const hasFailure = raw.statusCheckRollup.some((c) => c.state === 'FAILURE');\n const allSuccess = raw.statusCheckRollup.every(\n (c) => c.state === 'SUCCESS' || c.state === 'NEUTRAL' || c.state === 'SKIPPED'\n );\n checksStatus = hasFailure ? 'failure' : allSuccess ? 'success' : 'pending';\n }\n\n let reviewStatus: 'approved' | 'pending' | 'changes_requested' = 'pending';\n if (raw.reviewDecision === 'APPROVED') reviewStatus = 'approved';\n else if (raw.reviewDecision === 'CHANGES_REQUESTED') reviewStatus = 'changes_requested';\n\n return { mergeable, checksStatus, reviewStatus };\n}\n\n// ============================================================================\n// Provider Implementation\n// ============================================================================\n\n/**\n * GitHub provider using the gh CLI.\n *\n * Requires: gh CLI installed and authenticated.\n */\nexport class GitHubProvider implements IScmProvider {\n readonly platform = 'github' as const;\n\n constructor(readonly repo: string) {}\n\n async getIssue(number: number): Promise<Result<ScmIssue, ScmError>> {\n const fields = 'number,title,body,labels,author,createdAt';\n const args = ['issue', 'view', String(number), '--json', fields];\n\n logger.debug('Getting issue', { repo: this.repo, number });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n\n try {\n return ok(mapIssue(JSON.parse(result.value) as GhIssueJson));\n } catch (error) {\n return err(\n new ScmError(\n `Failed to parse issue JSON: ${getErrorMessage(error)} — preview: ${result.value.slice(0, 120)}`,\n 'github'\n )\n );\n }\n }\n\n async listIssues(filters?: IssueFilters): Promise<Result<readonly ScmIssue[], ScmError>> {\n const fields = 'number,title,body,labels,author,createdAt';\n const args = ['issue', 'list', '--json', fields];\n\n if (filters?.labels !== undefined && filters.labels.length > 0) {\n args.push('--label', filters.labels.join(','));\n }\n if (filters?.state !== undefined) {\n args.push('--state', filters.state);\n }\n args.push('--limit', String(filters?.limit ?? 50));\n\n logger.debug('Listing issues', { repo: this.repo, filters });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n\n try {\n const issues = JSON.parse(result.value) as GhIssueJson[];\n return ok(issues.map(mapIssue));\n } catch (error) {\n return err(\n new ScmError(\n `Failed to parse issues JSON: ${getErrorMessage(error)} — preview: ${result.value.slice(0, 120)}`,\n 'github'\n )\n );\n }\n }\n\n async addLabels(issueNumber: number, labels: readonly string[]): Promise<Result<void, ScmError>> {\n const args = ['issue', 'edit', String(issueNumber), '--add-label', labels.join(',')];\n\n logger.debug('Adding labels', { repo: this.repo, issueNumber, labels });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n return ok(undefined);\n }\n\n async createPR(options: CreatePROptions): Promise<Result<ScmPullRequest, ScmError>> {\n const fields = 'number,title,body,url,author,baseRefName,headRefName';\n const args = [\n 'pr',\n 'create',\n '--title',\n options.title,\n '--body',\n options.body,\n '--head',\n options.head,\n '--base',\n options.base,\n '--json',\n fields,\n ];\n\n logger.info('Creating PR', { repo: this.repo, title: options.title });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n\n try {\n const raw = JSON.parse(result.value) as GhPrJson;\n return ok({\n number: raw.number,\n title: raw.title,\n body: raw.body ?? '',\n author: raw.author.login,\n base: raw.baseRefName,\n head: raw.headRefName,\n url: raw.url,\n });\n } catch (error) {\n return err(\n new ScmError(\n `Failed to parse PR JSON: ${getErrorMessage(error)} — preview: ${result.value.slice(0, 120)}`,\n 'github'\n )\n );\n }\n }\n\n async mergePR(prNumber: number, options?: MergePROptions): Promise<Result<void, ScmError>> {\n const method = options?.method ?? 'squash';\n const args = ['pr', 'merge', String(prNumber), `--${method}`];\n\n if (options?.commitTitle !== undefined) args.push('--subject', options.commitTitle);\n if (options?.commitMessage !== undefined) args.push('--body', options.commitMessage);\n if (options?.deleteBranch === true) args.push('--delete-branch');\n\n logger.info('Merging PR', { repo: this.repo, prNumber, method });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n return ok(undefined);\n }\n\n async getPRStatus(prNumber: number): Promise<Result<PRStatus, ScmError>> {\n const fields = 'mergeable,statusCheckRollup,reviewDecision';\n const args = ['pr', 'view', String(prNumber), '--json', fields];\n\n logger.debug('Getting PR status', { repo: this.repo, prNumber });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n\n try {\n return ok(mapPRStatus(JSON.parse(result.value) as GhPrStatusJson));\n } catch (error) {\n return err(\n new ScmError(\n `Failed to parse PR status JSON: ${getErrorMessage(error)} — preview: ${result.value.slice(0, 120)}`,\n 'github'\n )\n );\n }\n }\n\n async createIssue(\n title: string,\n body: string,\n labels?: readonly string[]\n ): Promise<Result<ScmIssue, ScmError>> {\n const args = ['issue', 'create', '--title', title, '--body', body];\n if (labels !== undefined && labels.length > 0) args.push('--label', labels.join(','));\n logger.debug('Creating issue', { repo: this.repo, title });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n const url = result.value.trim();\n const match = /\\/(\\d+)$/.exec(url);\n const number = match?.[1] !== undefined ? parseInt(match[1], 10) : 0;\n return ok({\n number,\n title,\n body,\n labels: labels !== undefined ? [...labels] : [],\n author: 'pipeline',\n createdAt: new Date().toISOString(),\n });\n }\n\n async addComment(issueNumber: number, body: string): Promise<Result<void, ScmError>> {\n const args = ['issue', 'comment', String(issueNumber), '--body', body];\n\n logger.debug('Adding comment', { repo: this.repo, issueNumber });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n return ok(undefined);\n }\n\n async listComments(issueNumber: number): Promise<Result<readonly ScmComment[], ScmError>> {\n const args = ['issue', 'view', String(issueNumber), '--json', 'comments', '--jq', '.comments'];\n\n logger.debug('Listing comments', { repo: this.repo, issueNumber });\n const result = await execGh(args, this.repo);\n if (!result.ok) return result;\n\n try {\n const comments = JSON.parse(result.value) as GhCommentJson[];\n return ok(comments.map(mapComment));\n } catch (error) {\n return err(\n new ScmError(\n `Failed to parse comments JSON: ${getErrorMessage(error)} — preview: ${result.value.slice(0, 120)}`,\n 'github'\n )\n );\n }\n }\n}\n"],"mappings":"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","names":[]}