@f5-sales-demo/xcsh 22.2.0 → 22.3.1

package/src/modes/components/model-selector.ts

@@ -1,5 +1,11 @@
 import { ThinkingLevel } from "@f5-sales-demo/pi-agent-core";
-import { getSupportedReasoningEfforts, type Model, modelsAreEqual, ReasoningEffort } from "@f5-sales-demo/pi-ai";
+import {
+	type CodexContextTier,
+	getSupportedReasoningEfforts,
+	type Model,
+	modelsAreEqual,
+	ReasoningEffort,
+} from "@f5-sales-demo/pi-ai";
 import {
 	Container,
 	getKeybindings,
@@ -58,6 +64,10 @@ export function reasoningLabel(level: ThinkingLevel): string {
 		}[level] ?? level
 	);
 }
+
+function formatContextSize(tokens: number): string {
+	return `${Math.round(tokens / 1_000)}K`;
+}
 export interface ModelNavigationContext {
 	initialSearchInput?: string;
 	initialProvider?: string;
@@ -312,6 +322,8 @@ export interface ModelSelection {
 	model: Model;
 	selector: string;
 	thinkingLevel: ThinkingLevel;
+	/** Provider-wide context policy, present only for supported OpenAI routes. */
+	contextTier?: CodexContextTier;
 	role?: string;
 }
 type RoleSelectCallback = (selection: ModelSelection) => boolean | undefined | Promise<boolean | undefined>;
@@ -398,19 +410,28 @@ export class ModelSelectorComponent extends Container {
 		];
 		if (this.#isMenuOpen && selected) {
 			details.push(...wrapTextWithAnsi(selected.selector, inner));
-			title = getModelDisplayName(selected.model);
+			title =
+				this.#menuStep === "thinking"
+					? "Reasoning"
+					: this.#menuStep === "context"
+						? "Context window"
+						: getModelDisplayName(selected.model);
 			const labels =
-				this.#menuStep === "scope"
-					? this.#scopeActions()
-					: this.#menuStep === "role"
-						? this.#menuRoleActions.map(action => action.label)
-						: this.#getThinkingLevelsForModel(selected.model).map(reasoningLabel);
+				this.#menuStep === "context"
+					? this.#contextActions(selected.model).map(action => action.label)
+					: this.#menuStep === "scope"
+						? this.#scopeActions()
+						: this.#menuStep === "role"
+							? this.#menuRoleActions.map(action => action.label)
+							: this.#getThinkingLevelsForModel(selected.model).map(reasoningLabel);
 			purpose =
 				this.#menuStep === "thinking"
-					? `Reasoning · ${this.#menuScope === "conversation" ? "This conversation" : this.#menuScope === "default" ? "Saved default" : `Role: ${this.#menuSelectedRole}`}`
-					: this.#menuStep === "scope"
-						? "Choose where this model applies."
-						: "Choose a specialist role.";
+					? "Choose reasoning for this model."
+					: this.#menuStep === "context"
+						? "This provider-wide setting controls the usable context window. Scope controls only the model and reasoning assignment."
+						: this.#menuStep === "scope"
+							? "Choose where this model applies."
+							: "Choose a specialist role.";
 			body = labels.map((label, i) => selectorRow([label], [inner - 2], i === this.#menuSelectedIndex));
 			selectedBodyIndex = this.#menuSelectedIndex;
 			if (this.#menuStep === "scope")
@@ -422,10 +443,17 @@ export class ModelSelectorComponent extends Container {
 					][this.#menuSelectedIndex],
 				);
 			else if (this.#menuStep === "thinking") details.push(`Reasoning: ${labels[this.#menuSelectedIndex]}`);
+			else if (this.#menuStep === "context") {
+				const context = this.#contextActions(selected.model)[this.#menuSelectedIndex];
+				if (context) {
+					details.push(`Usable window: ${formatContextSize(context.effectiveContextWindow)}.`);
+					details.push(`Automatic compaction begins at ${formatContextSize(context.autoCompactTokenLimit)}.`);
+				}
+			}
 			if (this.#errorMessage)
 				details.push(`Could not apply: ${String(this.#errorMessage)}. ${selectorKeys("confirm")} to retry.`);
 			footer = [
-				selectorNavigationHint(this.#menuStep === "thinking" ? "confirm" : "continue"),
+				selectorNavigationHint(this.#menuStep === "scope" || this.#menuStep === "role" ? "continue" : "confirm"),
 				selectorCancelHint(),
 			];
 		} else {
@@ -585,13 +613,15 @@ export class ModelSelectorComponent extends Container {
 	// Context menu state
 	#isMenuOpen: boolean = false;
 	#menuSelectedIndex: number = 0;
-	#menuStep: "scope" | "role" | "thinking" = "scope";
+	#menuStep: "thinking" | "context" | "scope" | "role" = "thinking";
 	#menuScope: ModelSelection["scope"] = "conversation";
 	#menuItem?: ModelItem | CanonicalModelItem;
 	#applying = false;
 	#onLogin?: () => void;
 	#currentThinkingLevel: ThinkingLevel = ThinkingLevel.Inherit;
 	#menuSelectedRole: string | null = null;
+	#menuThinkingLevel: ThinkingLevel = ThinkingLevel.Inherit;
+	#menuContextTier?: CodexContextTier;
 
 	constructor(
 		tui: TUI,
@@ -1197,6 +1227,47 @@ export class ModelSelectorComponent extends Container {
 		return foundIndex >= 0 ? foundIndex : 0;
 	}
 
+	#contextSettingFor(model: Model): "providers.openaiContextTier" | "providers.litellmContextTier" | undefined {
+		if (model.provider === "openai-codex") return "providers.openaiContextTier";
+		if (model.provider === "litellm") return "providers.litellmContextTier";
+		return undefined;
+	}
+
+	#contextActions(model: Model): Array<{
+		tier: CodexContextTier;
+		label: string;
+		effectiveContextWindow: number;
+		autoCompactTokenLimit: number;
+	}> {
+		const setting = this.#contextSettingFor(model);
+		if (!setting || !model.maxContextWindow) return [];
+		// The registry has already clamped this to the safe advertised provider limit.
+		const providerMaximum = model.providerContextWindow ?? model.maxContextWindow;
+		const standard = Math.min(272_000, providerMaximum);
+		const codexMaximum = Math.min(model.maxContextWindow, providerMaximum);
+		const effectivePercent = model.effectiveContextWindowPercent ?? 95;
+		const compactPercent = model.autoCompactThresholdPercent ?? 90;
+		const current = this.#settings.get(setting) as CodexContextTier;
+		return [
+			["standard", "Standard", standard],
+			["codex-max", "Codex maximum", codexMaximum],
+			["provider-max", "Provider maximum", providerMaximum],
+		].map(([tier, label, size]) => ({
+			tier: tier as CodexContextTier,
+			label: `${label} — ${formatContextSize(size as number)}${tier === current ? " (current/default)" : ""}`,
+			effectiveContextWindow: Math.floor(((size as number) * effectivePercent) / 100),
+			autoCompactTokenLimit: Math.floor(((size as number) * compactPercent) / 100),
+		}));
+	}
+
+	#contextPreselectIndex(model: Model): number {
+		const setting = this.#contextSettingFor(model);
+		if (!setting) return 0;
+		const current = this.#settings.get(setting) as CodexContextTier;
+		const index = this.#contextActions(model).findIndex(action => action.tier === current);
+		return index >= 0 ? index : 0;
+	}
+
 	#getSelectedItem(): ModelItem | CanonicalModelItem | undefined {
 		return this.#isCanonicalTab()
 			? this.#filteredCanonicalModels[this.#selectedIndex]
@@ -1214,29 +1285,31 @@ export class ModelSelectorComponent extends Container {
 		if (!this.#menuItem || this.#isItemDisabled(this.#menuItem)) return;
 		this.#isMenuOpen = true;
 		this.#menuScope = "conversation";
-		this.#menuStep = "scope";
+		this.#menuStep = "thinking";
 		this.#menuSelectedRole = null;
-		this.#menuSelectedIndex = 0;
+		this.#menuThinkingLevel = this.#getThinkingLevelsForModel(this.#menuItem.model)[0] ?? ThinkingLevel.Inherit;
+		this.#menuContextTier = undefined;
+		this.#menuSelectedIndex = this.#getThinkingPreselectIndex("default", this.#menuItem.model);
 		this.#updateMenu();
 	}
 
-	#openThinkingMenu(role: string): void {
+	#openScopeMenu(): void {
 		const selected = this.#menuItem ?? this.#getSelectedItem();
 		if (!selected) return;
 		this.#menuItem = selected;
 		this.#isMenuOpen = true;
-		this.#menuStep = "thinking";
-		this.#menuSelectedRole = role;
-		this.#menuSelectedIndex = this.#getThinkingPreselectIndex(role, selected.model);
+		this.#menuStep = "scope";
+		this.#menuSelectedIndex = 0;
 		this.#updateMenu();
 	}
 
 	#closeMenu(): void {
 		this.#resetDetailPage();
 		this.#isMenuOpen = false;
-		this.#menuStep = "role";
+		this.#menuStep = "thinking";
 		this.#menuSelectedRole = null;
 		this.#menuItem = undefined;
+		this.#menuContextTier = undefined;
 		this.#updateList();
 	}
 
@@ -1336,11 +1409,13 @@ export class ModelSelectorComponent extends Container {
 		if (!selectedItem) return;
 
 		const optionCount =
-			this.#menuStep === "thinking" && this.#menuSelectedRole !== null
+			this.#menuStep === "thinking"
 				? this.#getThinkingLevelsForModel(selectedItem.model).length
-				: this.#menuStep === "scope"
-					? this.#scopeActions().length
-					: this.#menuRoleActions.length;
+				: this.#menuStep === "context"
+					? this.#contextActions(selectedItem.model).length
+					: this.#menuStep === "scope"
+						? this.#scopeActions().length
+						: this.#menuRoleActions.length;
 		if (optionCount === 0) return;
 
 		if (matchesSelectorKey(keyData, "up")) {
@@ -1356,13 +1431,31 @@ export class ModelSelectorComponent extends Container {
 		}
 
 		if (matchesSelectorKey(keyData, "confirm")) {
+			if (this.#menuStep === "thinking") {
+				const thinking = this.#getThinkingLevelsForModel(selectedItem.model)[this.#menuSelectedIndex];
+				if (!thinking) return;
+				this.#menuThinkingLevel = thinking;
+				if (this.#contextActions(selectedItem.model).length > 0) {
+					this.#menuStep = "context";
+					this.#menuSelectedIndex = this.#contextPreselectIndex(selectedItem.model);
+					this.#updateMenu();
+				} else this.#openScopeMenu();
+				return;
+			}
+			if (this.#menuStep === "context") {
+				const context = this.#contextActions(selectedItem.model)[this.#menuSelectedIndex];
+				if (!context) return;
+				this.#menuContextTier = context.tier;
+				this.#openScopeMenu();
+				return;
+			}
 			if (this.#menuStep === "scope") {
 				this.#menuScope = (["conversation", "default", "role"] as const)[this.#menuSelectedIndex];
 				if (this.#menuScope === "role") {
 					this.#menuStep = "role";
 					this.#menuSelectedIndex = 0;
 					this.#updateMenu();
-				} else this.#openThinkingMenu("default");
+				} else void this.#handleSelect(selectedItem, this.#menuThinkingLevel);
 				return;
 			}
 			if (this.#menuStep === "role") {
@@ -1370,27 +1463,41 @@ export class ModelSelectorComponent extends Container {
 				const action = this.#menuRoleActions[this.#menuSelectedIndex];
 				if (!action) return;
 				this.#menuSelectedRole = action.role;
-				this.#menuStep = "thinking";
-				this.#menuSelectedIndex = this.#getThinkingPreselectIndex(action.role, selectedItem.model);
-				this.#updateMenu();
+				void this.#handleSelect(selectedItem, this.#menuThinkingLevel);
 				return;
 			}
-
-			if (!this.#menuSelectedRole) return;
-			const thinkingOptions = this.#getThinkingLevelsForModel(selectedItem.model);
-			const thinkingLevel = thinkingOptions[this.#menuSelectedIndex];
-			if (!thinkingLevel) return;
-			void this.#handleSelect(selectedItem, thinkingLevel);
-			return;
 		}
 
 		if (getKeybindings().matches(keyData, "tui.select.cancel")) {
-			if (this.#menuStep === "thinking" && this.#menuSelectedRole !== null) {
-				this.#menuStep = this.#menuScope === "role" ? "role" : "scope";
-				const roleIndex = this.#menuRoleActions.findIndex(action => action.role === this.#menuSelectedRole);
+			if (this.#menuStep === "role") {
+				this.#menuStep = "scope";
 				this.#menuSelectedRole = null;
-				this.#menuSelectedIndex =
-					this.#menuScope === "role" ? Math.max(0, roleIndex) : this.#menuScope === "default" ? 1 : 0;
+				this.#menuSelectedIndex = 2;
+				this.#updateMenu();
+				return;
+			}
+			if (this.#menuStep === "scope") {
+				if (this.#contextActions(selectedItem.model).length > 0) {
+					this.#menuStep = "context";
+					this.#menuSelectedIndex = this.#contextActions(selectedItem.model).findIndex(
+						action => action.tier === this.#menuContextTier,
+					);
+					if (this.#menuSelectedIndex < 0)
+						this.#menuSelectedIndex = this.#contextPreselectIndex(selectedItem.model);
+				} else {
+					this.#menuStep = "thinking";
+					this.#menuSelectedIndex = this.#getThinkingLevelsForModel(selectedItem.model).indexOf(
+						this.#menuThinkingLevel,
+					);
+				}
+				this.#updateMenu();
+				return;
+			}
+			if (this.#menuStep === "context") {
+				this.#menuStep = "thinking";
+				this.#menuSelectedIndex = this.#getThinkingLevelsForModel(selectedItem.model).indexOf(
+					this.#menuThinkingLevel,
+				);
 				this.#updateMenu();
 				return;
 			}
@@ -1411,6 +1518,7 @@ export class ModelSelectorComponent extends Container {
 			model: item.model,
 			selector: item.selector,
 			thinkingLevel,
+			...(this.#menuContextTier ? { contextTier: this.#menuContextTier } : {}),
 			...(this.#menuScope === "role" ? { role: this.#menuSelectedRole! } : {}),
 		};
 		this.#applying = true;

package/src/modes/controllers/model-selection.ts

@@ -17,8 +17,21 @@ export function prepareModelSelection(session: AgentSession, selection: ModelSel
 		: "None";
 	const selectedModel = formatModelSelectorValue(selection.selector, selection.thinkingLevel);
 	const role = selection.scope === "default" ? "default" : selection.role;
+	const contextSetting =
+		selection.contextTier && model.provider === "openai-codex"
+			? "providers.openaiContextTier"
+			: selection.contextTier && model.provider === "litellm"
+				? "providers.litellmContextTier"
+				: undefined;
 	const routingState = session.getRoutingState();
 	const changes: Array<{ field: string; before: string; after: string }> = [];
+	if (contextSetting) {
+		changes.push({
+			field: "Provider-wide context tier",
+			before: String(session.settings.get(contextSetting)),
+			after: selection.contextTier!,
+		});
+	}
 	if (selection.scope !== "conversation") {
 		if (!role) return undefined;
 		changes.push({
@@ -56,7 +69,7 @@ export function prepareModelSelection(session: AgentSession, selection: ModelSel
 			changes: changed,
 			consequence:
 				selection.scope === "conversation"
-					? "Switches this conversation and records a manual routing pin; user model defaults are unchanged."
+					? "Switches this conversation and records a manual routing pin; the selected provider-wide context tier is saved."
 					: selection.scope === "default"
 						? "Saves the user default role, then switches this conversation and records a manual routing pin."
 						: `Saves the ${role} role for future routed work; the active conversation model is unchanged.`,
@@ -71,6 +84,13 @@ export async function applyModelSelection(session: AgentSession, selection: Mode
 	const previousModel = session.model;
 	const previousThinking = session.thinkingLevel;
 	const previousRoles = { ...session.settings.get("modelRoles") };
+	const contextSetting =
+		selection.contextTier && model.provider === "openai-codex"
+			? "providers.openaiContextTier"
+			: selection.contextTier && model.provider === "litellm"
+				? "providers.litellmContextTier"
+				: undefined;
+	const previousContextTier = contextSetting ? session.settings.get(contextSetting) : undefined;
 	const previousRouting = session.getRoutingState();
 	let switched = false;
 	const role = scope === "default" ? "default" : selection.role;
@@ -80,10 +100,16 @@ export async function applyModelSelection(session: AgentSession, selection: Mode
 		throw new Error(`No API key for ${selector}`);
 	}
 	try {
-		if (scope !== "conversation") {
-			session.settings.setModelRole(role!, formatModelSelectorValue(selector, thinkingLevel));
+		if (scope !== "conversation" || contextSetting) {
+			if (scope !== "conversation")
+				session.settings.setModelRole(role!, formatModelSelectorValue(selector, thinkingLevel));
+			if (contextSetting) session.settings.set(contextSetting, selection.contextTier!);
 			await session.settings.flush({ throwOnError: true });
 		}
+		if (contextSetting) {
+			if (model.provider === "openai-codex") session.modelRegistry.setOpenAIContextTier(selection.contextTier!);
+			else session.modelRegistry.setLiteLLMContextTier(selection.contextTier!);
+		}
 		if (scope !== "role") {
 			switched = true;
 			await session.setModelTemporary(model, thinkingLevel);
@@ -101,10 +127,15 @@ export async function applyModelSelection(session: AgentSession, selection: Mode
 			await session.sessionManager.flush();
 		}
 	} catch (error) {
-		if (scope !== "conversation") {
+		if (scope !== "conversation" || contextSetting) {
 			session.settings.set("modelRoles", previousRoles);
+			if (contextSetting) session.settings.set(contextSetting, previousContextTier!);
 			await session.settings.flush({ throwOnError: true }).catch(() => {});
 		}
+		if (contextSetting) {
+			if (model.provider === "openai-codex") session.modelRegistry.setOpenAIContextTier(previousContextTier!);
+			else session.modelRegistry.setLiteLLMContextTier(previousContextTier!);
+		}
 		if (switched && previousModel) await session.setModelTemporary(previousModel, previousThinking);
 		session.restoreRoutingState(previousRouting);
 		if (switched) {

package/src/prompts/rules/llms-search.md

@@ -3,7 +3,9 @@
 For conceptual, product, operational, and support questions, search `xcsh://documentation/?search=<query>` first.
 Select the best result and read its exact follow-up URL,
 `xcsh://documentation/<source>/<stable-path>/index.md`, before answering. Use the source filter when the question
-clearly targets `docs-cloud-f5-com` or `my-f5-com`.
+clearly targets `docs-cloud-f5-com`, `my-f5-com`, or `www-f5-com`. Prefer `www-f5-com` for conceptual and product
+questions, `docs-cloud-f5-com` for configuration and procedures, and `my-f5-com` for troubleshooting and support.
+An explicit source filter is authoritative.
 
 Render documentation images only when the user explicitly asks to see them. Extract all unique Markdown image references
 from the exact document, resolve relative references against its exact `xcsh://documentation/` URI, and

package/src/prompts/system/system-prompt.md

@@ -494,6 +494,8 @@ For conceptual, product, operational, or support questions about F5 Distributed
 search `xcsh://documentation/?search=<query>` first, then read the exact
 `xcsh://documentation/<source>/<stable-path>/index.md` result before answering. The search result
 is discovery; the exact Markdown document is the evidence.
+Prefer `www-f5-com` for conceptual and product questions, `docs-cloud-f5-com` for configuration and
+procedural questions, and `my-f5-com` for troubleshooting and support. An explicit source filter is authoritative.
 
 ### Documentation images
 

package/src/qmd-smoke.ts

@@ -6,7 +6,11 @@ import {
 	createEmbeddedDocumentationRepository,
 	type EmbeddedDocumentationRepository,
 } from "./internal-urls/documentation-repository";
-import type { DocumentationRepository, DocumentationSearchResult } from "./internal-urls/documentation-resolve";
+import type {
+	DocumentationRepository,
+	DocumentationSearchResult,
+	DocumentationSource,
+} from "./internal-urls/documentation-resolve";
 import { convertToPng } from "./utils/image-convert";
 
 export const QMD_SMOKE_SUCCESS = "XCSH_QMD_SMOKE_OK";
@@ -17,6 +21,10 @@ const EXPECTED_CATEGORY = "dns-dns-zone-clone-from-dns-domain";
 const WAF_QUERY = "configure web application firewall";
 const WAF_PATH = "docs/how-to/app-security/web-app-firewall";
 const WAF_TITLE = "Create Web Application Firewall";
+const MARKETING_QUERY = "what is client side defense";
+const MARKETING_PATH = "products/distributed-cloud-services/client-side-defense";
+const MARKETING_TITLE = "F5 Distributed Cloud Client-Side Defense";
+const MARKETING_SOURCE = "www-f5-com" as const;
 const DNS_QUERY = "set up DNS load balancer";
 const DNS_PATH = "dns-management/how-to/configure-dns-load-balancer";
 const DNS_TITLE = "Set Up DNS Load Balancer";
@@ -31,6 +39,8 @@ const EXPECTED_EVENTS = [
 	"api-catalog-rank",
 	"documentation-search",
 	"documentation-read",
+	"documentation-marketing-search",
+	"documentation-marketing-read",
 	"documentation-search",
 	"documentation-read",
 	"documentation-follow-up-read",
@@ -47,7 +57,7 @@ export interface QmdSmokeTraceEntry {
 	readonly event: QmdSmokeEvent;
 	readonly resource?: string;
 	readonly title?: string;
-	readonly source?: typeof SOURCE;
+	readonly source?: DocumentationSource;
 	readonly category?: string;
 	readonly outcome?: string;
 }
@@ -59,12 +69,12 @@ export interface QmdSmokeOptions {
 	documentationRepository?: DocumentationRepository;
 }
 
-function searchUri(query: string): string {
-	return `xcsh://documentation/?search=${encodeURIComponent(query)}&source=${SOURCE}&limit=1`;
+function searchUri(query: string, source: DocumentationSource = SOURCE): string {
+	return `xcsh://documentation/?search=${encodeURIComponent(query)}&source=${source}&limit=1`;
 }
 
-function documentUri(stablePath: string): string {
-	return `xcsh://documentation/${SOURCE}/${stablePath}/index.md`;
+function documentUri(stablePath: string, source: DocumentationSource = SOURCE): string {
+	return `xcsh://documentation/${source}/${stablePath}/index.md`;
 }
 
 function assetUri(stablePath: string, filename: string): string {
@@ -75,11 +85,12 @@ function assertSearchResult(
 	result: DocumentationSearchResult | undefined,
 	expectedPath: string,
 	expectedTitle: string,
-): DocumentationSearchResult & { source: typeof SOURCE } {
-	if (result?.source !== SOURCE || result.stablePath !== expectedPath || result.title !== expectedTitle) {
-		throw new Error(`Documentation QMD smoke expected ${expectedTitle} at ${SOURCE}/${expectedPath}`);
+	expectedSource: DocumentationSource = SOURCE,
+): DocumentationSearchResult {
+	if (result?.source !== expectedSource || result.stablePath !== expectedPath || result.title !== expectedTitle) {
+		throw new Error(`Documentation QMD smoke expected ${expectedTitle} at ${expectedSource}/${expectedPath}`);
 	}
-	return result as DocumentationSearchResult & { source: typeof SOURCE };
+	return result;
 }
 
 /** Parse and strictly validate stdout from the installed-binary QMD smoke driver. */
@@ -109,6 +120,8 @@ export function parseQmdSmokeOutput(output: string): QmdSmokeTraceEntry[] {
 	const expectedResources = [
 		searchUri(WAF_QUERY),
 		documentUri(WAF_PATH),
+		searchUri(MARKETING_QUERY, MARKETING_SOURCE),
+		documentUri(MARKETING_PATH, MARKETING_SOURCE),
 		searchUri(DNS_QUERY),
 		documentUri(DNS_PATH),
 		documentUri(DNS_PATH),
@@ -126,16 +139,20 @@ export function parseQmdSmokeOutput(output: string): QmdSmokeTraceEntry[] {
 		if (trace[index]?.title !== WAF_TITLE || trace[index]?.source !== SOURCE)
 			throw new Error("QMD smoke trace contains unexpected WAF identity");
 	}
-	for (const index of [3, 4, 5]) {
+	for (const index of [3, 4]) {
+		if (trace[index]?.title !== MARKETING_TITLE || trace[index]?.source !== MARKETING_SOURCE)
+			throw new Error("QMD smoke trace contains unexpected marketing identity");
+	}
+	for (const index of [5, 6, 7]) {
 		if (trace[index]?.title !== DNS_TITLE || trace[index]?.source !== SOURCE)
 			throw new Error("QMD smoke trace contains unexpected DNS identity");
 	}
-	if (trace[6]?.outcome !== "no-match-no-fetch") throw new Error("QMD smoke trace did not fail closed");
-	if (trace[7]?.outcome !== DOCUMENTATION_TOOLS_DISABLED_MESSAGE)
+	if (trace[8]?.outcome !== "no-match-no-fetch") throw new Error("QMD smoke trace did not fail closed");
+	if (trace[9]?.outcome !== DOCUMENTATION_TOOLS_DISABLED_MESSAGE)
 		throw new Error("QMD smoke trace omitted the tools-disabled explanation");
-	if (trace[8]?.source !== SOURCE || trace[8].outcome !== "image/png")
+	if (trace[10]?.source !== SOURCE || trace[10].outcome !== "image/png")
 		throw new Error("QMD smoke trace contains an unexpected SVG conversion result");
-	if (trace[9]?.outcome !== "ok") throw new Error("QMD smoke trace did not confirm SQLite startup");
+	if (trace[11]?.outcome !== "ok") throw new Error("QMD smoke trace did not confirm SQLite startup");
 	return trace;
 }
 
@@ -173,6 +190,32 @@ export async function runQmdSmoke(options: QmdSmokeOptions = {}): Promise<string
 	}
 	emit({ event: "documentation-read", resource: documentUri(WAF_PATH), title: wafDocument.title, source: SOURCE });
 
+	const marketing = assertSearchResult(
+		(await documentation.search(MARKETING_QUERY, MARKETING_SOURCE, 1))[0],
+		MARKETING_PATH,
+		MARKETING_TITLE,
+		MARKETING_SOURCE,
+	);
+	emit({
+		event: "documentation-marketing-search",
+		resource: searchUri(MARKETING_QUERY, MARKETING_SOURCE),
+		title: marketing.title,
+		source: marketing.source,
+	});
+	const marketingDocument = await documentation.readDocument(MARKETING_SOURCE, MARKETING_PATH);
+	if (
+		marketingDocument?.title !== MARKETING_TITLE ||
+		!marketingDocument.markdown.includes("# F5 Client-Side Defense")
+	) {
+		throw new Error("Documentation QMD smoke could not read exact marketing Markdown");
+	}
+	emit({
+		event: "documentation-marketing-read",
+		resource: documentUri(MARKETING_PATH, MARKETING_SOURCE),
+		title: marketingDocument.title,
+		source: MARKETING_SOURCE,
+	});
+
 	const dns = assertSearchResult((await documentation.search(DNS_QUERY, SOURCE, 1))[0], DNS_PATH, DNS_TITLE);
 	emit({ event: "documentation-search", resource: searchUri(DNS_QUERY), title: dns.title, source: dns.source });
 	const dnsDocument = await documentation.readDocument(SOURCE, DNS_PATH);