@bbradar/mcp 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release notes
 
+## 0.3.3 — confirmed program identities (2026-11-07)
+
+- `get_program_brief`, `get_program_scope_summary` and `get_program_target_breakdown` keep an identity that the exact detail read confirmed. When only the target list is unavailable, as for a finished contest, they return its 404 with a message pointing to `get_program` instead of retrying a same-handle program on another platform as a stale ID. Stale-ID retries still apply when the detail read also finds nothing.
+
 ## 0.3.2 — new Activity data, contest awards and dependency security (2026-11-07)
 
 - `find_programs` and `find_hunt_targets` now report the sort direction the API actually applied in `ranking_scope.sort_direction` and `scan.sort_direction`. With no `sort_direction`, the API ranks `first_response` and `time_to_bounty` fastest first (ascending), and these fields previously said `desc`. When the API does not echo a direction, the same rule applies.

package/dist/server.js

@@ -7,7 +7,7 @@ import { NumericCursorStore } from "./cursorStore.js";
 import { stableStringify, stripUndefined } from "./json.js";
 import { FixedWindowRateLimiter } from "./rateLimit.js";
 import { readArray, readBoolean, readNumber, readObject, readString, sanitizeJson, sanitizeProPayload, sanitizeChange, sanitizeProgram, sanitizeRepositoryChange, sanitizeTarget, sanitizeTargetsForExport } from "./sanitize.js";
-const SERVER_VERSION = "0.3.2";
+const SERVER_VERSION = "0.3.3";
 const MAX_PROGRAMS_PER_SEARCH = 100;
 const MAX_TARGET_EXPORT = 500;
 const MAX_RECENT_CHANGES = 100;
@@ -2833,7 +2833,7 @@ async function runProgramIdTool(client, config, requestedProgramId, callback, in
             return withProgramIdFallbackMetadata(payload, cachedFallback);
         }
         catch (cachedFallbackError) {
-            if (!isProgramNotFoundError(cachedFallbackError) || !indexFallbackCallback) {
+            if (!allowsProgramIdFallback(cachedFallbackError) || !indexFallbackCallback) {
                 throw cachedFallbackError;
             }
             const indexFallback = createProgramIndexFallbackFromStaleResolution(cachedFallback, requestedProgramId, cachedFallbackError) ??
@@ -2855,7 +2855,7 @@ async function runProgramIdTool(client, config, requestedProgramId, callback, in
                 return withProgramIdFallbackMetadata(payload, fallback);
             }
             catch (fallbackError) {
-                if (!isProgramNotFoundError(fallbackError) || !indexFallbackCallback) {
+                if (!allowsProgramIdFallback(fallbackError) || !indexFallbackCallback) {
                     throw fallbackError;
                 }
                 const indexFallback = createProgramIndexFallbackFromStaleResolution(fallback, requestedProgramId, fallbackError) ??
@@ -2883,7 +2883,7 @@ async function runProgramIdTool(client, config, requestedProgramId, callback, in
         return await callback(requestedProgramId);
     }
     catch (error) {
-        if (!isProgramNotFoundError(error)) {
+        if (!allowsProgramIdFallback(error)) {
             throw error;
         }
         const fallback = await resolveStaleProgramId(client, config, requestedProgramId, error);
@@ -2905,7 +2905,7 @@ async function runProgramIdTool(client, config, requestedProgramId, callback, in
             return withProgramIdFallbackMetadata(payload, fallback);
         }
         catch (fallbackError) {
-            if (!isProgramNotFoundError(fallbackError) || !indexFallbackCallback) {
+            if (!allowsProgramIdFallback(fallbackError) || !indexFallbackCallback) {
                 throw fallbackError;
             }
             const indexFallback = createProgramIndexFallbackFromStaleResolution(fallback, requestedProgramId, fallbackError) ??
@@ -5157,7 +5157,20 @@ async function getProgramFromTargetsOnlyFallback(client, programId, programError
 async function fetchProgramDetailsAndTargets(client, config, programId) {
     const [programResult, targetsResult] = await Promise.allSettled([client.getProgram(programId), client.getProgramTargets(programId)]);
     if (targetsResult.status === "rejected") {
-        throw targetsResult.reason;
+        const reason = targetsResult.reason;
+        if (programResult.status === "fulfilled" && isProgramNotFoundError(reason)) {
+            // Detail confirmed this exact program; only its target list is unavailable.
+            throw new ConfirmedProgramTargetsError({
+                message: `${programId} exists, but its target list is not available (${reason.message}). A finished contest keeps program detail only: read it with get_program.`,
+                requestId: reason.requestId,
+                upstreamRequestId: reason.upstreamRequestId,
+                status: reason.status,
+                detail: reason.detail,
+                errors: reason.errors,
+                cause: reason
+            });
+        }
+        throw reason;
     }
     const targetsApi = targetsResult.value;
     const targetSourceRequest = {
@@ -8935,6 +8948,16 @@ function addUniqueWarning(warnings, warning) {
 function isProgramNotFoundError(error) {
     return error instanceof BBRadarApiError && error.status === 404;
 }
+/**
+ * A target read failed for a program whose exact detail read succeeded. Detail confirmed
+ * the identity, so the failure belongs to that program's targets (a finished contest keeps
+ * detail only) and never makes its ID a stale-ID candidate for a same-handle program.
+ */
+class ConfirmedProgramTargetsError extends BBRadarApiError {
+}
+function allowsProgramIdFallback(error) {
+    return isProgramNotFoundError(error) && !(error instanceof ConfirmedProgramTargetsError);
+}
 function runImmediately(callback) {
     return callback();
 }