@f5-sales-demo/xcsh 19.51.2

package/package.json

@@ -0,0 +1,539 @@
+{
+	"type": "module",
+	"name": "@f5-sales-demo/xcsh",
+	"version": "19.51.2",
+	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
+	"homepage": "https://github.com/f5-sales-demo/xcsh",
+	"author": "Can Boluk",
+	"contributors": [
+		"Mario Zechner"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/f5-sales-demo/xcsh.git",
+		"directory": "packages/coding-agent"
+	},
+	"bugs": {
+		"url": "https://github.com/f5-sales-demo/xcsh/issues"
+	},
+	"keywords": [
+		"coding-agent",
+		"ai",
+		"llm",
+		"cli",
+		"tui",
+		"agent"
+	],
+	"main": "./src/index.ts",
+	"types": "./src/index.ts",
+	"bin": {
+		"xcsh": "src/cli.ts"
+	},
+	"scripts": {
+		"build": "bun run generate-build-info && bun run generate-api-spec-index && bun run generate-branding-index && bun run generate-terraform-index && bun run generate-console-catalog && bun run generate-console-field-metadata && test -f src/internal-urls/api-spec-index.generated.ts && bun --cwd=../stats scripts/generate-client-bundle.ts --generate && bun --cwd=../natives run embed:native && bun build --compile --define PI_COMPILED=true --external mupdf --root ../.. ./src/cli.ts --outfile dist/xcsh && bun --cwd=../natives run embed:native --reset && bun --cwd=../stats scripts/generate-client-bundle.ts --reset",
+		"check": "biome check . && bun run format-prompts -- --check && bun run check:types",
+		"check:types": "bun run generate-build-info && bun run generate-api-spec-index && bun run generate-branding-index && bun run generate-terraform-index && tsgo -p tsconfig.json --noEmit",
+		"lint": "biome lint .",
+		"test": "bun run generate-build-info && bun run generate-api-spec-index && bun run generate-console-catalog && bun run generate-console-field-metadata && bun test --max-concurrency 4",
+		"fix": "biome check --write --unsafe . && bun run format-prompts && bun run generate-docs-index && bun run generate-api-spec-index && bun run generate-build-info",
+		"fmt": "biome format --write . && bun run format-prompts",
+		"format-prompts": "bun scripts/format-prompts.ts",
+		"mermaid:gallery": "bun scripts/mermaid-gallery.ts",
+		"generate-docs-index": "bun scripts/generate-docs-index.ts",
+		"generate-api-spec-index": "bun scripts/generate-api-spec-index.ts",
+		"generate-branding-index": "bun scripts/generate-branding-index.ts",
+		"generate-build-info": "bun scripts/generate-build-info.ts",
+		"generate-terraform-index": "bun scripts/generate-terraform-index.ts",
+		"generate-console-catalog": "bun scripts/generate-console-catalog.ts",
+		"generate-console-field-metadata": "bun scripts/generate-console-field-metadata.ts",
+		"prepack": "bun scripts/generate-docs-index.ts && bun scripts/generate-api-spec-index.ts && bun scripts/generate-build-info.ts && bun scripts/generate-terraform-index.ts && bun scripts/generate-console-catalog.ts && bun scripts/generate-console-field-metadata.ts",
+		"generate-template": "bun scripts/generate-template.ts",
+		"check-workflow-field-coverage": "bun scripts/check-workflow-field-coverage.ts"
+	},
+	"dependencies": {
+		"@agentclientprotocol/sdk": "0.16.1",
+		"@mozilla/readability": "^0.6",
+		"@f5-sales-demo/xcsh-stats": "workspace:*",
+		"@f5-sales-demo/pi-agent-core": "workspace:*",
+		"@f5-sales-demo/pi-ai": "workspace:*",
+		"@f5-sales-demo/pi-natives": "workspace:*",
+		"@f5-sales-demo/pi-resource-management": "workspace:*",
+		"@f5-sales-demo/pi-tui": "workspace:*",
+		"@f5-sales-demo/pi-utils": "workspace:*",
+		"@sinclair/typebox": "^0.34",
+		"@xterm/headless": "^6.0",
+		"ajv": "^8.20",
+		"chalk": "^5.6",
+		"diff": "^8.0",
+		"fflate": "0.8.2",
+		"handlebars": "^4.7",
+		"linkedom": "^0.18",
+		"lru-cache": "11.3.1",
+		"markit-ai": "0.5.0",
+		"puppeteer": "^24.37",
+		"yaml": "2.9.0",
+		"zod": "4.3.6"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3"
+	},
+	"engines": {
+		"bun": ">=1.3.7"
+	},
+	"files": [
+		"src",
+		"scripts",
+		"examples",
+		"README.md",
+		"CHANGELOG.md"
+	],
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"import": "./src/index.ts"
+		},
+		"./*": {
+			"types": "./src/*.ts",
+			"import": "./src/*.ts"
+		},
+		"./async": {
+			"types": "./src/async/index.ts",
+			"import": "./src/async/index.ts"
+		},
+		"./async/*": {
+			"types": "./src/async/*.ts",
+			"import": "./src/async/*.ts"
+		},
+		"./autoresearch": {
+			"types": "./src/autoresearch/index.ts",
+			"import": "./src/autoresearch/index.ts"
+		},
+		"./autoresearch/*": {
+			"types": "./src/autoresearch/*.ts",
+			"import": "./src/autoresearch/*.ts"
+		},
+		"./autoresearch/tools/*": {
+			"types": "./src/autoresearch/tools/*.ts",
+			"import": "./src/autoresearch/tools/*.ts"
+		},
+		"./capability": {
+			"types": "./src/capability/index.ts",
+			"import": "./src/capability/index.ts"
+		},
+		"./capability/*": {
+			"types": "./src/capability/*.ts",
+			"import": "./src/capability/*.ts"
+		},
+		"./cli/*": {
+			"types": "./src/cli/*.ts",
+			"import": "./src/cli/*.ts"
+		},
+		"./cli/commands/*": {
+			"types": "./src/cli/commands/*.ts",
+			"import": "./src/cli/commands/*.ts"
+		},
+		"./commands/*": {
+			"types": "./src/commands/*.ts",
+			"import": "./src/commands/*.ts"
+		},
+		"./commit": {
+			"types": "./src/commit/index.ts",
+			"import": "./src/commit/index.ts"
+		},
+		"./commit/*": {
+			"types": "./src/commit/*.ts",
+			"import": "./src/commit/*.ts"
+		},
+		"./commit/agentic": {
+			"types": "./src/commit/agentic/index.ts",
+			"import": "./src/commit/agentic/index.ts"
+		},
+		"./commit/agentic/*": {
+			"types": "./src/commit/agentic/*.ts",
+			"import": "./src/commit/agentic/*.ts"
+		},
+		"./commit/agentic/tools": {
+			"types": "./src/commit/agentic/tools/index.ts",
+			"import": "./src/commit/agentic/tools/index.ts"
+		},
+		"./commit/agentic/tools/*": {
+			"types": "./src/commit/agentic/tools/*.ts",
+			"import": "./src/commit/agentic/tools/*.ts"
+		},
+		"./commit/analysis": {
+			"types": "./src/commit/analysis/index.ts",
+			"import": "./src/commit/analysis/index.ts"
+		},
+		"./commit/analysis/*": {
+			"types": "./src/commit/analysis/*.ts",
+			"import": "./src/commit/analysis/*.ts"
+		},
+		"./commit/changelog": {
+			"types": "./src/commit/changelog/index.ts",
+			"import": "./src/commit/changelog/index.ts"
+		},
+		"./commit/changelog/*": {
+			"types": "./src/commit/changelog/*.ts",
+			"import": "./src/commit/changelog/*.ts"
+		},
+		"./commit/git/*": {
+			"types": "./src/commit/git/*.ts",
+			"import": "./src/commit/git/*.ts"
+		},
+		"./commit/map-reduce": {
+			"types": "./src/commit/map-reduce/index.ts",
+			"import": "./src/commit/map-reduce/index.ts"
+		},
+		"./commit/map-reduce/*": {
+			"types": "./src/commit/map-reduce/*.ts",
+			"import": "./src/commit/map-reduce/*.ts"
+		},
+		"./commit/utils/*": {
+			"types": "./src/commit/utils/*.ts",
+			"import": "./src/commit/utils/*.ts"
+		},
+		"./config/*": {
+			"types": "./src/config/*.ts",
+			"import": "./src/config/*.ts"
+		},
+		"./dap": {
+			"types": "./src/dap/index.ts",
+			"import": "./src/dap/index.ts"
+		},
+		"./dap/*": {
+			"types": "./src/dap/*.ts",
+			"import": "./src/dap/*.ts"
+		},
+		"./debug": {
+			"types": "./src/debug/index.ts",
+			"import": "./src/debug/index.ts"
+		},
+		"./debug/*": {
+			"types": "./src/debug/*.ts",
+			"import": "./src/debug/*.ts"
+		},
+		"./discovery": {
+			"types": "./src/discovery/index.ts",
+			"import": "./src/discovery/index.ts"
+		},
+		"./discovery/*": {
+			"types": "./src/discovery/*.ts",
+			"import": "./src/discovery/*.ts"
+		},
+		"./edit": {
+			"types": "./src/edit/index.ts",
+			"import": "./src/edit/index.ts"
+		},
+		"./edit/*": {
+			"types": "./src/edit/*.ts",
+			"import": "./src/edit/*.ts"
+		},
+		"./edit/modes/*": {
+			"types": "./src/edit/modes/*.ts",
+			"import": "./src/edit/modes/*.ts"
+		},
+		"./exa": {
+			"types": "./src/exa/index.ts",
+			"import": "./src/exa/index.ts"
+		},
+		"./exa/*": {
+			"types": "./src/exa/*.ts",
+			"import": "./src/exa/*.ts"
+		},
+		"./exec/*": {
+			"types": "./src/exec/*.ts",
+			"import": "./src/exec/*.ts"
+		},
+		"./export/*": {
+			"types": "./src/export/*.ts",
+			"import": "./src/export/*.ts"
+		},
+		"./export/html": {
+			"types": "./src/export/html/index.ts",
+			"import": "./src/export/html/index.ts"
+		},
+		"./export/html/*": {
+			"types": "./src/export/html/*.ts",
+			"import": "./src/export/html/*.ts"
+		},
+		"./extensibility/*": {
+			"types": "./src/extensibility/*.ts",
+			"import": "./src/extensibility/*.ts"
+		},
+		"./extensibility/custom-commands": {
+			"types": "./src/extensibility/custom-commands/index.ts",
+			"import": "./src/extensibility/custom-commands/index.ts"
+		},
+		"./extensibility/custom-commands/*": {
+			"types": "./src/extensibility/custom-commands/*.ts",
+			"import": "./src/extensibility/custom-commands/*.ts"
+		},
+		"./extensibility/custom-commands/bundled/ci-green": {
+			"types": "./src/extensibility/custom-commands/bundled/ci-green/index.ts",
+			"import": "./src/extensibility/custom-commands/bundled/ci-green/index.ts"
+		},
+		"./extensibility/custom-commands/bundled/review": {
+			"types": "./src/extensibility/custom-commands/bundled/review/index.ts",
+			"import": "./src/extensibility/custom-commands/bundled/review/index.ts"
+		},
+		"./extensibility/custom-tools": {
+			"types": "./src/extensibility/custom-tools/index.ts",
+			"import": "./src/extensibility/custom-tools/index.ts"
+		},
+		"./extensibility/custom-tools/*": {
+			"types": "./src/extensibility/custom-tools/*.ts",
+			"import": "./src/extensibility/custom-tools/*.ts"
+		},
+		"./extensibility/extensions": {
+			"types": "./src/extensibility/extensions/index.ts",
+			"import": "./src/extensibility/extensions/index.ts"
+		},
+		"./extensibility/extensions/*": {
+			"types": "./src/extensibility/extensions/*.ts",
+			"import": "./src/extensibility/extensions/*.ts"
+		},
+		"./extensibility/hooks": {
+			"types": "./src/extensibility/hooks/index.ts",
+			"import": "./src/extensibility/hooks/index.ts"
+		},
+		"./extensibility/hooks/*": {
+			"types": "./src/extensibility/hooks/*.ts",
+			"import": "./src/extensibility/hooks/*.ts"
+		},
+		"./extensibility/plugins": {
+			"types": "./src/extensibility/plugins/index.ts",
+			"import": "./src/extensibility/plugins/index.ts"
+		},
+		"./extensibility/plugins/*": {
+			"types": "./src/extensibility/plugins/*.ts",
+			"import": "./src/extensibility/plugins/*.ts"
+		},
+		"./extensibility/plugins/marketplace": {
+			"types": "./src/extensibility/plugins/marketplace/index.ts",
+			"import": "./src/extensibility/plugins/marketplace/index.ts"
+		},
+		"./extensibility/plugins/marketplace/*": {
+			"types": "./src/extensibility/plugins/marketplace/*.ts",
+			"import": "./src/extensibility/plugins/marketplace/*.ts"
+		},
+		"./internal-urls": {
+			"types": "./src/internal-urls/index.ts",
+			"import": "./src/internal-urls/index.ts"
+		},
+		"./internal-urls/*": {
+			"types": "./src/internal-urls/*.ts",
+			"import": "./src/internal-urls/*.ts"
+		},
+		"./ipy/*": {
+			"types": "./src/ipy/*.ts",
+			"import": "./src/ipy/*.ts"
+		},
+		"./lsp": {
+			"types": "./src/lsp/index.ts",
+			"import": "./src/lsp/index.ts"
+		},
+		"./lsp/*": {
+			"types": "./src/lsp/*.ts",
+			"import": "./src/lsp/*.ts"
+		},
+		"./lsp/clients": {
+			"types": "./src/lsp/clients/index.ts",
+			"import": "./src/lsp/clients/index.ts"
+		},
+		"./lsp/clients/*": {
+			"types": "./src/lsp/clients/*.ts",
+			"import": "./src/lsp/clients/*.ts"
+		},
+		"./mcp": {
+			"types": "./src/mcp/index.ts",
+			"import": "./src/mcp/index.ts"
+		},
+		"./mcp/*": {
+			"types": "./src/mcp/*.ts",
+			"import": "./src/mcp/*.ts"
+		},
+		"./mcp/transports": {
+			"types": "./src/mcp/transports/index.ts",
+			"import": "./src/mcp/transports/index.ts"
+		},
+		"./mcp/transports/*": {
+			"types": "./src/mcp/transports/*.ts",
+			"import": "./src/mcp/transports/*.ts"
+		},
+		"./memories": {
+			"types": "./src/memories/index.ts",
+			"import": "./src/memories/index.ts"
+		},
+		"./memories/*": {
+			"types": "./src/memories/*.ts",
+			"import": "./src/memories/*.ts"
+		},
+		"./modes": {
+			"types": "./src/modes/index.ts",
+			"import": "./src/modes/index.ts"
+		},
+		"./modes/*": {
+			"types": "./src/modes/*.ts",
+			"import": "./src/modes/*.ts"
+		},
+		"./modes/acp": {
+			"types": "./src/modes/acp/index.ts",
+			"import": "./src/modes/acp/index.ts"
+		},
+		"./modes/acp/*": {
+			"types": "./src/modes/acp/*.ts",
+			"import": "./src/modes/acp/*.ts"
+		},
+		"./modes/components": {
+			"types": "./src/modes/components/index.ts",
+			"import": "./src/modes/components/index.ts"
+		},
+		"./modes/components/*": {
+			"types": "./src/modes/components/*.ts",
+			"import": "./src/modes/components/*.ts"
+		},
+		"./modes/components/extensions": {
+			"types": "./src/modes/components/extensions/index.ts",
+			"import": "./src/modes/components/extensions/index.ts"
+		},
+		"./modes/components/extensions/*": {
+			"types": "./src/modes/components/extensions/*.ts",
+			"import": "./src/modes/components/extensions/*.ts"
+		},
+		"./modes/components/status-line": {
+			"types": "./src/modes/components/status-line/index.ts",
+			"import": "./src/modes/components/status-line/index.ts"
+		},
+		"./modes/components/status-line/*": {
+			"types": "./src/modes/components/status-line/*.ts",
+			"import": "./src/modes/components/status-line/*.ts"
+		},
+		"./modes/controllers/*": {
+			"types": "./src/modes/controllers/*.ts",
+			"import": "./src/modes/controllers/*.ts"
+		},
+		"./modes/rpc/*": {
+			"types": "./src/modes/rpc/*.ts",
+			"import": "./src/modes/rpc/*.ts"
+		},
+		"./modes/theme/*": {
+			"types": "./src/modes/theme/*.ts",
+			"import": "./src/modes/theme/*.ts"
+		},
+		"./modes/theme/defaults": {
+			"types": "./src/modes/theme/defaults/index.ts",
+			"import": "./src/modes/theme/defaults/index.ts"
+		},
+		"./modes/utils/*": {
+			"types": "./src/modes/utils/*.ts",
+			"import": "./src/modes/utils/*.ts"
+		},
+		"./plan-mode/*": {
+			"types": "./src/plan-mode/*.ts",
+			"import": "./src/plan-mode/*.ts"
+		},
+		"./prompts/*": "./src/prompts/*.md",
+		"./secrets": {
+			"types": "./src/secrets/index.ts",
+			"import": "./src/secrets/index.ts"
+		},
+		"./secrets/*": {
+			"types": "./src/secrets/*.ts",
+			"import": "./src/secrets/*.ts"
+		},
+		"./services/*": {
+			"types": "./src/services/*.ts",
+			"import": "./src/services/*.ts"
+		},
+		"./session/*": {
+			"types": "./src/session/*.ts",
+			"import": "./src/session/*.ts"
+		},
+		"./session/compaction": {
+			"types": "./src/session/compaction/index.ts",
+			"import": "./src/session/compaction/index.ts"
+		},
+		"./session/compaction/*": {
+			"types": "./src/session/compaction/*.ts",
+			"import": "./src/session/compaction/*.ts"
+		},
+		"./slash-commands/*": {
+			"types": "./src/slash-commands/*.ts",
+			"import": "./src/slash-commands/*.ts"
+		},
+		"./ssh/*": {
+			"types": "./src/ssh/*.ts",
+			"import": "./src/ssh/*.ts"
+		},
+		"./stt": {
+			"types": "./src/stt/index.ts",
+			"import": "./src/stt/index.ts"
+		},
+		"./stt/*": {
+			"types": "./src/stt/*.ts",
+			"import": "./src/stt/*.ts"
+		},
+		"./task": {
+			"types": "./src/task/index.ts",
+			"import": "./src/task/index.ts"
+		},
+		"./task/*": {
+			"types": "./src/task/*.ts",
+			"import": "./src/task/*.ts"
+		},
+		"./tools": {
+			"types": "./src/tools/index.ts",
+			"import": "./src/tools/index.ts"
+		},
+		"./tools/*": {
+			"types": "./src/tools/*.ts",
+			"import": "./src/tools/*.ts"
+		},
+		"./tui": {
+			"types": "./src/tui/index.ts",
+			"import": "./src/tui/index.ts"
+		},
+		"./tui/*": {
+			"types": "./src/tui/*.ts",
+			"import": "./src/tui/*.ts"
+		},
+		"./utils/*": {
+			"types": "./src/utils/*.ts",
+			"import": "./src/utils/*.ts"
+		},
+		"./web/*": {
+			"types": "./src/web/*.ts",
+			"import": "./src/web/*.ts"
+		},
+		"./web/scrapers": {
+			"types": "./src/web/scrapers/index.ts",
+			"import": "./src/web/scrapers/index.ts"
+		},
+		"./web/scrapers/*": {
+			"types": "./src/web/scrapers/*.ts",
+			"import": "./src/web/scrapers/*.ts"
+		},
+		"./web/search": {
+			"types": "./src/web/search/index.ts",
+			"import": "./src/web/search/index.ts"
+		},
+		"./web/search/*": {
+			"types": "./src/web/search/*.ts",
+			"import": "./src/web/search/*.ts"
+		},
+		"./web/search/providers/*": {
+			"types": "./src/web/search/providers/*.ts",
+			"import": "./src/web/search/providers/*.ts"
+		},
+		"./hooks": {
+			"types": "./src/extensibility/hooks/index.ts",
+			"import": "./src/extensibility/hooks/index.ts"
+		},
+		"./hooks/*": {
+			"types": "./src/extensibility/hooks/*.ts",
+			"import": "./src/extensibility/hooks/*.ts"
+		},
+		"./*.js": "./src/*.ts"
+	}
+}

package/scripts/build-info/resolvers.ts

@@ -0,0 +1,51 @@
+export interface EnvLike {
+	readonly XCSH_BUILD_COMMIT?: string;
+	readonly XCSH_BUILD_BRANCH?: string;
+	readonly XCSH_BUILD_TAG?: string;
+	readonly XCSH_BUILD_PR?: string;
+}
+
+export type GitFn = (args: string[]) => Promise<string>;
+export type GhFn = (sha: string) => Promise<string>;
+
+function pick(value: string | undefined): string {
+	return value?.trim() ?? "";
+}
+
+export async function resolveCommit(env: EnvLike, git: GitFn): Promise<string> {
+	return pick(env.XCSH_BUILD_COMMIT) || (await git(["rev-parse", "HEAD"]));
+}
+
+export async function resolveBranch(env: EnvLike, git: GitFn): Promise<string> {
+	const override = pick(env.XCSH_BUILD_BRANCH);
+	if (override) return override;
+
+	const local = await git(["rev-parse", "--abbrev-ref", "HEAD"]);
+	if (local && local !== "HEAD") return local;
+
+	const remote = await git(["branch", "-r", "--contains", "HEAD"]);
+	for (const raw of remote.split("\n")) {
+		const line = raw.trim();
+		if (!line || line.includes("->") || line === "HEAD") continue;
+		const stripped = line.replace(/^origin\//, "");
+		if (stripped && stripped !== "HEAD") return stripped;
+	}
+
+	return "unknown";
+}
+
+export async function resolveTag(env: EnvLike, git: GitFn): Promise<string> {
+	return pick(env.XCSH_BUILD_TAG) || (await git(["describe", "--exact-match", "--tags", "HEAD"]));
+}
+
+export async function resolveDirty(_env: EnvLike, git: GitFn): Promise<boolean> {
+	const status = await git(["status", "--porcelain"]);
+	return status.length > 0;
+}
+
+export async function resolvePrNumber(sha: string, env: EnvLike, gh: GhFn): Promise<string> {
+	const override = pick(env.XCSH_BUILD_PR);
+	if (override) return override;
+	if (!sha) return "";
+	return await gh(sha);
+}

package/scripts/capture-ax-fixture.ts

@@ -0,0 +1,84 @@
+#!/usr/bin/env bun
+// One-shot capture: login + open the HTTP-LB create form + snapshot the accessibility tree.
+// Creds via env (XCSH_USERNAME/XCSH_CONSOLE_PASSWORD); never hard-coded. Output is the resolver's test oracle.
+import puppeteer from "puppeteer";
+
+const CHROME = process.env.CHROME_PATH;
+const BASE = process.env.XCSH_CONSOLE_URL ?? "https://nferreira.staging.volterra.us";
+const NS = process.env.XCSH_NS ?? "demo";
+const OUT = "test/browser/fixtures/xc-http-lb-create.ax.json";
+
+const browser = await puppeteer.launch({
+	headless: true,
+	executablePath: CHROME,
+	userDataDir: "/tmp/xc-ax-capture",
+});
+try {
+	const page = (await browser.pages())[0] ?? (await browser.newPage());
+	await page.goto(BASE, { waitUntil: "networkidle2", timeout: 45000 }).catch(() => {});
+	if (/login-staging\.volterra\.us/.test(page.url())) {
+		await page.waitForSelector("#username", { timeout: 20000 });
+		await page.type("#username", process.env.XCSH_USERNAME ?? "");
+		await page.type("#password", process.env.XCSH_CONSOLE_PASSWORD ?? "");
+		await Promise.all([
+			page.waitForNavigation({ waitUntil: "networkidle2", timeout: 45000 }).catch(() => {}),
+			page.click("#kc-login").catch(() => page.keyboard.press("Enter")),
+		]);
+		await new Promise(r => setTimeout(r, 4000));
+	}
+	const route = `/web/workspaces/web-app-and-api-protection/namespaces/${NS}/manage/load_balancers/http_loadbalancers`;
+	await page.goto(`${BASE}${route}`, { waitUntil: "networkidle2", timeout: 45000 });
+	await new Promise(r => setTimeout(r, 4000));
+	// open the create form: click the "Add HTTP Load Balancer" tab via its resolved handle
+	{
+		const h = (await page.$("aria/Add HTTP Load Balancer")) ?? (await page.$("text/Add HTTP Load Balancer"));
+		if (!h) {
+			console.log("could not resolve the Add tab handle");
+		} else {
+			await h.click().catch(async () => {
+				await h.evaluate(el => (el as { click(): void }).click()).catch(() => {});
+			});
+			await h.dispose();
+		}
+	}
+	// wait until the create form's Name textbox is present in the AX tree (form actually open)
+	let opened = false;
+	for (let i = 0; i < 40; i++) {
+		await new Promise(r => setTimeout(r, 1000));
+		const s = await page.accessibility.snapshot({ interestingOnly: false });
+		const hasName = (function find(n: { role?: string; name?: string; children?: unknown[] }): boolean {
+			if (n.role === "textbox" && (n.name ?? "").trim() === "Name") return true;
+			return (n.children ?? []).some(c => find(c as never));
+		})((s ?? {}) as never);
+		if (hasName) {
+			opened = true;
+			break;
+		}
+	}
+	console.log("create form opened (Name textbox present):", opened, "url=", page.url().slice(0, 110));
+	const snap = await page.accessibility.snapshot({ interestingOnly: false });
+	if (!snap) throw new Error("accessibility snapshot was null");
+	await Bun.write(OUT, JSON.stringify(snap, null, 2));
+	// also capture the create-form DOM root (for DOM-structural context-scoping tests)
+	const HTML_OUT = "test/browser/fixtures/xc-http-lb-create.html";
+	const formHtml = await page.evaluate(() => {
+		const d = (
+			globalThis as unknown as {
+				document: { querySelector(s: string): { outerHTML: string } | null; body: { outerHTML: string } };
+			}
+		).document;
+		const root = d.querySelector('[role="main"], main, .ant-drawer-body, .ant-modal-body') ?? d.body;
+		return root.outerHTML;
+	});
+	await Bun.write(HTML_OUT, formHtml);
+	console.log(`wrote ${HTML_OUT} (${formHtml.length} bytes)`);
+	const json = JSON.stringify(snap);
+	const roleCount = (role: string) => (json.match(new RegExp(`"role":"${role}"`, "g")) ?? []).length;
+	console.log(`wrote ${OUT} (${json.length} bytes)`);
+	console.log(`url=${page.url().slice(0, 90)}`);
+	console.log(
+		`roles: tab=${roleCount("tab")} textbox=${roleCount("textbox")} button=${roleCount("button")} listbox=${roleCount("listbox")}`,
+	);
+} finally {
+	await browser.close().catch(() => {});
+}