@f5-sales-demo/xcsh 21.35.0 → 21.35.1

package/package.json

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

package/src/internal-urls/api-catalog-discovery.ts

@@ -0,0 +1,103 @@
+import { createHash } from "node:crypto";
+import type { ApiCatalogCategory, ApiCatalogIndex } from "./api-catalog-types";
+
+export interface ApiCatalogDiscoveryDocument {
+	readonly id: string;
+	readonly categoryName: string;
+	readonly markdown: string;
+}
+
+export interface ApiCatalogDiscoveryCorpus {
+	readonly catalogVersion: string;
+	readonly documents: readonly ApiCatalogDiscoveryDocument[];
+}
+
+export interface ApiCatalogDiscoveryCandidate {
+	readonly categoryName: string;
+	readonly destination: string;
+}
+
+export function normalizeApiCatalogDiscoveryTerm(value: string): string {
+	return value.toLowerCase().replace(/[_\s]+/g, "-");
+}
+
+/** The legacy text predicate extracted without changing its semantics. */
+export function matchesBaselineCatalogDiscoveryTerm(term: string, values: readonly string[]): boolean {
+	const normalized = normalizeApiCatalogDiscoveryTerm(term);
+	return values.some(value => normalizeApiCatalogDiscoveryTerm(value).includes(normalized));
+}
+
+function categoryDocument(category: ApiCatalogCategory): ApiCatalogDiscoveryDocument {
+	const destination = `xcsh://api-catalog/${category.name}`;
+	const operations = category.operations.flatMap(operation => [
+		`- Operation: ${operation.name}`,
+		`  - Alias: ${(operation.operationAliases ?? []).join(", ")}`,
+		`  - Description: ${operation.description}`,
+		`  - Method: ${operation.method.toUpperCase()}`,
+		`  - Path: ${operation.path}`,
+		`  - Operation ID: ${operation.operationId}`,
+	]);
+
+	return {
+		id: `category:${category.name}`,
+		categoryName: category.name,
+		markdown: [
+			`# ${category.displayName}`,
+			"",
+			`- Category: ${category.name}`,
+			`- Destination: ${destination}`,
+			"",
+			"## Operations",
+			...(operations.length > 0 ? operations : ["- None"]),
+			"",
+		].join("\n"),
+	};
+}
+
+/**
+ * Produces a stable, authoritative-only corpus. It intentionally contains no
+ * tenant data, credentials, generated examples, or speculative API fields.
+ */
+export function buildApiCatalogDiscoveryCorpus(
+	index: ApiCatalogIndex,
+	data: Readonly<Record<string, ApiCatalogCategory>>,
+): ApiCatalogDiscoveryCorpus {
+	return {
+		catalogVersion: index.version,
+		documents: Object.values(data)
+			.slice()
+			.sort((left, right) => left.name.localeCompare(right.name))
+			.map(categoryDocument),
+	};
+}
+
+export function fingerprintApiCatalogDiscoveryCorpus(
+	corpus: ApiCatalogDiscoveryCorpus,
+	sourceSha: string,
+	engineVersion: string,
+): string {
+	const bytes = JSON.stringify({
+		sourceSha,
+		catalogVersion: corpus.catalogVersion,
+		engineVersion,
+		documents: corpus.documents,
+	});
+	return createHash("sha256").update(bytes).digest("hex");
+}
+
+/**
+ * Byte-equivalent baseline candidate selection for the existing renderer.
+ * Ranking is intentionally unchanged: canonical CRUD promotion stays in the
+ * renderer where it has access to API-spec evidence.
+ */
+export function rankBaselineCatalogDiscovery(
+	term: string,
+	corpus: ApiCatalogDiscoveryCorpus,
+): readonly ApiCatalogDiscoveryCandidate[] {
+	return corpus.documents
+		.filter(document => matchesBaselineCatalogDiscoveryTerm(term, [document.markdown]))
+		.map(document => ({
+			categoryName: document.categoryName,
+			destination: `xcsh://api-catalog/${document.categoryName}`,
+		}));
+}

package/src/internal-urls/api-catalog-resolve.ts

@@ -1,3 +1,4 @@
+import { matchesBaselineCatalogDiscoveryTerm, normalizeApiCatalogDiscoveryTerm } from "./api-catalog-discovery";
 import type {
 	ApiCatalogCategory,
 	ApiCatalogCategorySummary,
@@ -7,10 +8,6 @@ import type {
 import type { ApiSpecDomainResource, ApiSpecIndex } from "./api-spec-types";
 import type { InternalResource, InternalUrl } from "./types";
 
-function normalizeSearchTerm(s: string): string {
-	return s.toLowerCase().replace(/[_\s]+/g, "-");
-}
-
 function normalizeApiPath(apiPath: string): string {
 	return apiPath.replace(/\{(?:metadata|system_metadata)\.(namespace|name)\}/g, "{$1}");
 }
@@ -165,13 +162,15 @@ function renderCatalogSearch(
 	term: string,
 	specIndex?: ApiSpecIndex,
 ): string {
-	const normalized = normalizeSearchTerm(term);
 	const matchingResources = (specIndex?.domains ?? []).flatMap(domain =>
 		domain.resources
 			.filter(resource =>
-				[resource.name, resource.description, resource.descriptionShort ?? "", ...(resource.apiPaths ?? [])].some(
-					value => normalizeSearchTerm(value).includes(normalized),
-				),
+				matchesBaselineCatalogDiscoveryTerm(term, [
+					resource.name,
+					resource.description,
+					resource.descriptionShort ?? "",
+					...(resource.apiPaths ?? []),
+				]),
 			)
 			.map(resource => ({ domain: domain.domain, resource })),
 	);
@@ -188,11 +187,14 @@ function renderCatalogSearch(
 			const category = data[summary.name];
 			return (
 				resourceCategoryNames.has(summary.name) ||
-				[summary.name, summary.displayName].some(value => normalizeSearchTerm(value).includes(normalized)) ||
+				matchesBaselineCatalogDiscoveryTerm(term, [summary.name, summary.displayName]) ||
 				(category?.operations ?? []).some(operation =>
-					[operation.name, operation.description, operation.path, operation.operationId].some(value =>
-						normalizeSearchTerm(value).includes(normalized),
-					),
+					matchesBaselineCatalogDiscoveryTerm(term, [
+						operation.name,
+						operation.description,
+						operation.path,
+						operation.operationId,
+					]),
 				)
 			);
 		})
@@ -573,8 +575,8 @@ function renderListableTypes(
 function renderUnknownCategory(requested: string, summaries: readonly ApiCatalogCategorySummary[]): string {
 	const suggestions = summaries
 		.filter(c => {
-			const norm = normalizeSearchTerm(requested);
-			const normName = normalizeSearchTerm(c.name);
+			const norm = normalizeApiCatalogDiscoveryTerm(requested);
+			const normName = normalizeApiCatalogDiscoveryTerm(c.name);
 			return normName.includes(norm) || norm.includes(normName.slice(0, 4));
 		})
 		.slice(0, 5);

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "21.35.0",
-	"commit": "1fdeb1fe5f311e79fb2c2adcf15747d39217429e",
-	"shortCommit": "1fdeb1f",
+	"version": "21.35.1",
+	"commit": "40f00db4bf790b604f5aeed3762eaa469b707392",
+	"shortCommit": "40f00db",
 	"branch": "main",
-	"tag": "v21.35.0",
-	"commitDate": "2026-09-20T16:50:31+00:00",
-	"buildDate": "2026-09-20T17:54:09.870Z",
+	"tag": "v21.35.1",
+	"commitDate": "2026-09-20T21:15:00+00:00",
+	"buildDate": "2026-09-20T22:15:10.342Z",
 	"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/1fdeb1fe5f311e79fb2c2adcf15747d39217429e",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v21.35.0"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/40f00db4bf790b604f5aeed3762eaa469b707392",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v21.35.1"
 };