@f5-sales-demo/xcsh 20.20.2 → 20.20.3

package/CHANGELOG.md

@@ -15,6 +15,14 @@
 - Unified generated and existing media publication behind the versioned `xcsh.media/v1` result
   contract so TUI, Browser, Office, RPC, and ACP transports no longer identify media by tool name
   ([#3202](https://github.com/f5-sales-demo/xcsh/issues/3202)).
+- Standardized documentation terminology, Handlebars prompt template rendering for `renderAboutDoc`,
+  Office add-in development test ownership, and language switcher links
+  ([#2848](https://github.com/f5-sales-demo/xcsh/issues/2848),
+   [#2999](https://github.com/f5-sales-demo/xcsh/issues/2999),
+   [#1327](https://github.com/f5-sales-demo/xcsh/issues/1327),
+   [#3001](https://github.com/f5-sales-demo/xcsh/issues/3001),
+   [#2850](https://github.com/f5-sales-demo/xcsh/issues/2850),
+   [#2514](https://github.com/f5-sales-demo/xcsh/issues/2514)).
 
 ### Fixed
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "20.20.2",
+	"version": "20.20.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -61,13 +61,13 @@
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "1.3.0",
-		"@f5-sales-demo/pi-agent-core": "20.20.2",
-		"@f5-sales-demo/pi-ai": "20.20.2",
-		"@f5-sales-demo/pi-natives": "20.20.2",
-		"@f5-sales-demo/pi-resource-management": "20.20.2",
-		"@f5-sales-demo/pi-tui": "20.20.2",
-		"@f5-sales-demo/pi-utils": "20.20.2",
-		"@f5-sales-demo/xcsh-stats": "20.20.2",
+		"@f5-sales-demo/pi-agent-core": "20.20.3",
+		"@f5-sales-demo/pi-ai": "20.20.3",
+		"@f5-sales-demo/pi-natives": "20.20.3",
+		"@f5-sales-demo/pi-resource-management": "20.20.3",
+		"@f5-sales-demo/pi-tui": "20.20.3",
+		"@f5-sales-demo/pi-utils": "20.20.3",
+		"@f5-sales-demo/xcsh-stats": "20.20.3",
 		"@mozilla/readability": "^0.6",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",

package/src/internal-urls/build-info-runtime.ts

@@ -2,6 +2,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { prompt } from "@f5-sales-demo/pi-utils";
 import { $ } from "bun";
+import aboutTemplate from "../prompts/internal-urls/about.md" with { type: "text" };
 import activeModelTemplate from "../prompts/internal-urls/active-model.md" with { type: "text" };
 import containmentTemplate from "../prompts/internal-urls/containment.md" with { type: "text" };
 import type { ContainmentStatus } from "../sandbox/containment";
@@ -182,133 +183,12 @@ export function renderAboutDoc(
 	model: ActiveModelSnapshot | null,
 	containment: ContainmentStatus | null,
 ): string {
-	return [
-		"# xcsh — identity and build fingerprint",
-		"",
-		"You are running inside xcsh, a coworker-style CLI for F5 sales engineers:",
-		"demos, docs, research, MEDDPICC, customer meeting prep, and day-to-day SE tasks.",
-		"This document is the authoritative answer when the user asks about xcsh itself.",
-		"",
-		"## Build fingerprint",
-		"",
-		`- Version: \`${info.version}\``,
-		`- Commit: \`${info.shortCommit || "unknown"}\` (full: \`${info.commit || "unknown"}\`)`,
-		`- Branch: \`${info.branch || "unknown"}\``,
-		`- Tag: ${info.tag ? `\`${info.tag}\`` : "(not a tagged build)"}`,
-		`- Commit date: ${info.commitDate || "unknown"}`,
-		`- Build date: ${info.buildDate || "unknown"}`,
-		`- Built from dirty tree: ${info.dirty ? "yes" : "no"}`,
-		`- PR that shipped this version: ${info.prNumber ? `#${info.prNumber}` : "unknown (resolve via gh if needed)"}`,
-		`- Provenance source: \`${info.source}\` (resolved at ${info.resolvedAt})`,
-		"",
-		renderPlatformContext(context, Date.now()),
-		renderActiveModel(model),
-		renderContainment(containment),
-		"## Source of truth",
-		"",
-		`- Repository: ${info.repoUrl}`,
-		`- Issues: ${info.repoUrl}/issues`,
-		`- Pull requests: ${info.repoUrl}/pulls`,
-		`- This commit on GitHub: ${info.commitUrl}`,
-		`- Release for this version: ${info.releaseUrl}`,
-		"",
-		"## Product knowledge",
-		"",
-		"xcsh serves F5 Distributed Cloud sales engineers. Product documentation is",
-		"federated across the f5-sales-demo GitHub organization. Entry point:",
-		"https://f5-sales-demo.github.io/docs/llms.txt",
-		"",
-		"Each product repo publishes: llms.txt (index with sidebar nav), custom sets",
-		"at /_llms-txt/{topic}.txt, per-page content at /{slug}.md, plus",
-		"llms-small.txt (compact) and llms-full.txt (complete).",
-		"",
-		"Every one of those exists per language as well: {locale}/llms.txt,",
-		"{locale}/llms-small.txt, {locale}/llms-full.txt, the tiered sets at",
-		"/_llms-txt/{locale}/{topic}.txt, and per-page content at /{locale}/{slug}.md.",
-		"The root llms.txt lists the languages under `## Translations`. When the user",
-		"is working in a language, read that language's set rather than translating the",
-		"default locale's — it is already written in their language. Locale segments",
-		"are slugs, not BCP-47 tags (pt-br, zh-cn, zh-tw). The default locale's",
-		"complete and abridged documents stay at the repo root, so its",
-		"{locale}/llms-full.txt is intentionally absent.",
-		"",
-		"## Lineage",
-		"",
-		"xcsh is a fork of [badlogic/pi-mono](https://github.com/badlogic/pi-mono).",
-		"Upstream authors: Mario Zechner (badlogic) and contributors. Fork maintainer:",
-		"f5-sales-demo. The fork adds F5 XC product knowledge,",
-		"SE-specific skills, and the federated llms.txt hierarchy.",
-		"",
-		"## Architecture",
-		"",
-		"| Package | Role |",
-		"|---------|------|",
-		"| `coding-agent` | System prompt, tool orchestration, agent loop |",
-		"| `agent` | Multi-agent coordination, subagent lifecycle |",
-		"| `ai` | LLM provider abstraction (Anthropic, OpenAI, etc.) |",
-		"| `tui` | Terminal UI, key bindings, themes |",
-		"| `natives` | Native Bun/Rust bindings (PTY, fs, crypto) |",
-		"| `stats` | Token counting, cost tracking |",
-		"| `utils` | Shared utilities, config, logging |",
-		"| `crates/pi-natives` | Rust native addon (compiled per-platform) |",
-		"",
-		"## Capabilities",
-		"",
-		"Sessions, MCP server/client, skills, TUI with themes, commit assistant,",
-		"Python REPL, native shell/PTY, provider-agnostic LLM routing, slash commands,",
-		"SSH remote execution, image generation and analysis.",
-		"",
-		"SE specialization: F5 XC API integration (xcsh_api, api-catalog, api-spec),",
-		"F5 XC federated product docs (llms.txt hierarchy),",
-		"F5 XC console browser automation (catalog_workflow_runner, xcsh://console/ workflow catalog),",
-		"SE-specific subagents (deal-analyst, status-operator, cli-operator, github-ops).",
-		"",
-		"## What to do when asked about xcsh itself",
-		"",
-		"1. The version above is authoritative — it is embedded at build time in this session's BUILD_INFO and also shown in the `<workstation>` header of the system prompt. Do not run `xcsh --version` to check — that reports the installed binary, which may differ from the running session after an upgrade. The **Active model** section is authoritative the same way: answer \"what model are you?\" from it, and never by running `xcsh -p`, which measures a new session's default rather than this one.",
-		'2. For recent changes / "what\'s new", read `xcsh://changes` — it lists merged PRs live and flags',
-		"   what shipped after your build (it falls back to `gh pr list` / `git log` when gh is unavailable).",
-		'   A fix may already be on `main`. For "where is X implemented?", read `xcsh://source`.',
-		"   For the class of the repository you are working in and what you may author there, read `xcsh://fleet`.",
-		"3. If behavior contradicts `xcsh://…` docs, read the actual source under the repo above to determine",
-		"   whether the binary is wrong or the doc is stale.",
-		"4. Classify the report as one of: **bug**, **feature**, **docs-drift**, or **config/usage**.",
-		"5. Offer to file it with",
-		"   `gh issue create --repo f5-sales-demo/xcsh --title ... --body ...`, referencing the commit above.",
-		"",
-		"## Self-improvement and editable surfaces",
-		"",
-		`The xcsh repository above is the **source of truth** for all xcsh behavior. The directory \`~/.xcsh/\` on the user's machine is *runtime config and state* (themes, skills they installed, session data) — it is **not** xcsh's source code, and editing it will not change shipped behavior.`,
-		"",
-		"When the user asks how to improve or modify xcsh, classify the change against `EDITABLE_SURFACES`:",
-		"",
-		"- **Soft surfaces (shippable via a normal PR to the repo above):**",
-		"  - System prompt fragments under `packages/coding-agent/src/prompts/`",
-		"  - Tool descriptions, internal-url doc renderers, and skill definitions",
-		"  - New skills, new `xcsh://` docs, keybinding defaults, theme defaults",
-		"- **Hard surfaces (require a compiled release — cannot hot-patch):**",
-		"  - The compiled binary, native Bun modules, and anything under `packages/*/native/`",
-		"  - Startup bootstrap and the build-info generator itself",
-		"",
-		"The improvement workflow is always: open an issue on the repo, then a PR. The user receives changes only after a new release is built and they upgrade. Do not claim a change is live until the commit above reflects it.",
-		"",
-		"You are a network-engineer assistant operating through GitHub, not a coding assistant: your job is",
-		"to author the issue, the reproduction, the Terraform/manifests/scripts/docs, and the PR description.",
-		"Whether **implementing** the change is yours depends on the repository's class — read `xcsh://fleet`.",
-		"xcsh itself is classified `developer`, so feature code here is delegated to a dedicated coding",
-		"harness (Claude Code / Codex) with its own dev environment; the same holds for the other `developer`",
-		"repositories such as `f5-sales-demo/marketplace` and `f5-sales-demo/api-specs-enriched`. In a",
-		"`content` repository you author directly.",
-		"To file well: clone the relevant repo, reproduce the behavior first, and follow `CONTRIBUTING.md` —",
-		"TDD, evidence required, no unverified claims.",
-		"",
-		"## What NOT to assume",
-		"",
-		"- Do not guess the repo URL, version, or commit — use the values above.",
-		"- Do not invent recent changes; fetch them at runtime via `gh` or `git`.",
-		"- Do not read this document unless the user asked about xcsh itself.",
-		"",
-	].join("\n");
+	return prompt.render(aboutTemplate, {
+		info,
+		platformContext: renderPlatformContext(context, Date.now()),
+		activeModel: renderActiveModel(model),
+		containment: renderContainment(containment),
+	});
 }
 
 // Bun-embedded module URL markers. Mirrors the native addon loader

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "20.20.2",
-	"commit": "04c71999d5ced53fa9200d3ae79a4ad2ba86debb",
-	"shortCommit": "04c7199",
+	"version": "20.20.3",
+	"commit": "4e9c88dd1a386f0396ff44b6e9c56c3e482c9e4a",
+	"shortCommit": "4e9c88d",
 	"branch": "main",
-	"tag": "v20.20.2",
-	"commitDate": "2026-08-17T12:59:16Z",
-	"buildDate": "2026-08-17T13:25:27.576Z",
+	"tag": "v20.20.3",
+	"commitDate": "2026-08-18T08:48:18Z",
+	"buildDate": "2026-08-18T09:19:44.080Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5-sales-demo/xcsh",
 	"repoSlug": "f5-sales-demo/xcsh",
-	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/04c71999d5ced53fa9200d3ae79a4ad2ba86debb",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v20.20.2"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/4e9c88dd1a386f0396ff44b6e9c56c3e482c9e4a",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v20.20.3"
 };

package/src/internal-urls/console-catalog.generated.ts

@@ -2,10 +2,10 @@
 
 import type { ConsoleCatalogData } from "./console-catalog-types";
 
-export const CONSOLE_CATALOG_VERSION = "1999b4cee787136ee0bc7cd02deba57ac6381885";
+export const CONSOLE_CATALOG_VERSION = "4e059e3ff2de43517ffd0b45c0d4d89485d34713";
 
 export const CONSOLE_CATALOG_DATA: ConsoleCatalogData = {
-	version: "1999b4cee787136ee0bc7cd02deba57ac6381885",
+	version: "4e059e3ff2de43517ffd0b45c0d4d89485d34713",
 	workflows: {
 		"address-allocator/create":
 			'---\nschema: urn:xcsh:console:workflow:v1\nid: address-allocator-create\nlabel: Create IP Address Allocators\nresource: address-allocator\noperation: create\npreconditions:\n  - user_logged_in\n  - "role_minimum: admin"\nparams:\n  name:\n    required: true\n    description: IP Address Allocators name (lowercase alphanumeric and hyphens)\n    example: example-address-allocator\n  address_allocator_mode:\n    required: true\n    description: Address Allocator Mode\n  allocation_unit:\n    required: false\n    description: Allocation Unit\n    default: 0\n  address_pool:\n    required: false\n    description: Address Pool\n    default: value\n  address_allocation_scheme:\n    required: false\n    description: "Server-required: Field should be not nil"\n    default: value\nsteps:\n  - id: navigate-to-list\n    action: navigate\n    url: /web/workspaces/multi-cloud-network-connect/manage/networking/legacy_network_configuration/address_allocators\n    wait_for: text(\'IP Address Allocators\')\n    description: Navigate to IP Address Allocators list page\n  - id: click-add-tab\n    action: click\n    selector: text(\'Add IP Address Allocator\')\n    wait_for: textbox[name=\'Name\']\n    description: Click Add IP Address Allocator to open the create form\n  - id: fill-name\n    action: fill\n    selector: textbox[name=\'Name\']\n    value: "{name}"\n    description: Enter Name\n  - id: select-address_allocator_mode\n    action: select\n    selector: listbox\n    context: Address Allocator Mode section\n    value: "{address_allocator_mode}"\n    description: Select Address Allocator Mode\n  - id: fill-allocation_unit\n    action: fill\n    selector: spinbutton[name=\'Allocation Unit\']\n    value: "{allocation_unit}"\n    description: Set Allocation Unit\n  - id: fill-address_pool\n    action: fill\n    selector: ngx-datatable input.form-control\n    context: Address Pool table\n    value: "{address_pool}"\n    description: Enter Address Pool in the existing table row (no Add Item needed — the table ships one empty row)\n  - id: select-address_allocation_scheme\n    action: select\n    selector: listbox\n    context: Address Allocation Scheme section\n    value: "{address_allocation_scheme}"\n    description: Select Address Allocation Scheme\n  - id: save\n    action: click\n    selector: "[class*=\'save-bt\'],[class*=\'submit-button\']"\n    context: footer\n    wait_for: text(\'{name}\')\n    wait_timeout_ms: 30000\n    description: Save/submit the form (union selector matches save-bt OR submit-button)\npostconditions:\n  - resource_list_page_visible\n  - "resource_name_in_list: {name}"\nmetadata:\n  confidence: inferred\n  discovered_at: 2026-06-24\n  console_version: "2025.06"\n  notes: Auto-generated by scripts/generate-workflows.ts from api-specs-enriched field metadata.\n',