@bridge_gpt/mcp-server 0.2.68 → 0.2.70

package/build/session-upgrade-notice.js

@@ -0,0 +1,86 @@
+/**
+ * The single "should this session be told about an upgrade?" decision (BAPI-1446).
+ *
+ * Every notice surface asks here: the startup instructions, the first completed
+ * tool result, the Claude SessionStart hook, the `ping` advice, and the
+ * `start-tickets` reminder. One synchronous, non-throwing function holds every
+ * eligibility and silence rule, so the surfaces cannot drift apart.
+ *
+ * Nothing in this module touches the network or starts asynchronous work. The
+ * only I/O is the synchronous read of the local update cache.
+ */
+import { parseDefaultOnEnvFlag } from "./env-flags.js";
+import { isNewerVersion, isPlainReleaseVersion, readCachedLatestVersion, readFakeLatestOverride, } from "./update-check.js";
+import { formatSessionUpgradeNotice } from "./upgrade-advice.js";
+/** The kill switch for every update check and notice. Default on. */
+export const UPDATE_CHECK_ENABLED_ENV = "BAPI_MCP_UPDATE_CHECK_ENABLED";
+/** Worker markers: either one means no person is watching the session. */
+export const UNATTENDED_MARKER_ENVS = [
+    "BAPI_WORKER_BRANCH",
+    "BAPI_EPIC_IMPLEMENTER_WORKER_ID",
+];
+const SILENT = { show: false };
+/** True when either worker marker holds a non-empty string. */
+export function isUnattendedSession(env) {
+    return UNATTENDED_MARKER_ENVS.some((name) => {
+        const value = env[name];
+        return typeof value === "string" && value.trim().length > 0;
+    });
+}
+/**
+ * Decide whether to show the upgrade notice. Never throws and never starts
+ * asynchronous work.
+ *
+ * Silence comes first: a disabled kill switch, an unattended session, or an
+ * invalid current version returns `{ show: false }` before any latest-version
+ * source is read.
+ *
+ * Latest-version sources, in order:
+ *   1. a valid `BAPI_MCP_UPDATE_CHECK_FAKE_LATEST` override;
+ *   2. a reliable, known authoritative latest from a settled live check, which
+ *      stays authoritative even when it says "current" and an older cache
+ *      would suggest an update;
+ *   3. the local cache, when the authoritative source is absent, still in
+ *      flight, or failed.
+ *
+ * The cache ignores its own age on purpose. It is a lower bound: it can
+ * under-claim an update but never claims one that does not exist. Unknown,
+ * equal, older, or invalid versions are silent.
+ */
+export function getNoticeDecision(env, currentVersion, authoritativeLatest) {
+    try {
+        if (!parseDefaultOnEnvFlag(env[UPDATE_CHECK_ENABLED_ENV]))
+            return SILENT;
+        if (isUnattendedSession(env))
+            return SILENT;
+        if (!isPlainReleaseVersion(currentVersion))
+            return SILENT;
+        let latest = readFakeLatestOverride(env);
+        if (latest === null &&
+            authoritativeLatest &&
+            authoritativeLatest.known === true &&
+            isPlainReleaseVersion(authoritativeLatest.latest)) {
+            latest = authoritativeLatest.latest;
+        }
+        if (latest === null)
+            latest = readCachedLatestVersion(env);
+        if (!isPlainReleaseVersion(latest))
+            return SILENT;
+        if (!isNewerVersion(currentVersion, latest))
+            return SILENT;
+        return { show: true, current: currentVersion, latest };
+    }
+    catch {
+        return SILENT;
+    }
+}
+/**
+ * Append the session notice to the server's startup instructions when eligible.
+ * The base string is returned unchanged when the decision is silent.
+ */
+export function composeServerInstructions(baseInstructions, env, currentVersion) {
+    const decision = getNoticeDecision(env, currentVersion);
+    if (!decision.show)
+        return baseInstructions;
+    return `${baseInstructions} ${formatSessionUpgradeNotice(decision.current, decision.latest)}`;
+}