@f5xc-salesdemos/xcsh 17.5.2 → 18.1.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Flipped eight user-facing factory defaults for new users:
+  - `defaultThinkingLevel`: `"high"` → `"xhigh"`
+  - `hideThinkingBlock`: `false` → `true`
+  - `interruptMode`: `"immediate"` → `"wait"`
+  - `todo.eager`: `false` → `true`
+  - `grep.contextBefore`: `0` → `3`
+  - `grep.contextAfter`: `0` → `3`
+  - `task.eager`: `false` → `true`
+  - `secrets.enabled`: `false` → `true`
+  - Existing users keep any value they have already saved in `config.yml`; no force-migration runs.
+
 ## [15.0.0] - 2026-04-10
 
 ### Fixed
@@ -9,6 +22,7 @@
 - Fixed cached Ollama discovery rows so upgraded installs switch to the OpenAI Responses transport instead of staying on the old completions transport
 
 ## [14.0.2] - 2026-04-09
+
 ### Added
 
 - Added `/force` slash command to force the next agent turn to use a specific tool
@@ -1562,7 +1576,7 @@
 ### Fixed
 
 - Restored inline rendering for `read` tool image results in assistant transcript components, including streaming and rebuilt session history paths.
-- Fixed shell-escaped read paths (for example, pasted `\ `-escaped screenshot filenames) by resolving unescaped fallback candidates before macOS filename normalization variants.
+- Fixed shell-escaped read paths (for example, pasted backslash-escaped screenshot filenames) by resolving unescaped fallback candidates before macOS filename normalization variants.
 
 ## [13.3.8] - 2026-02-28
 
@@ -4458,7 +4472,7 @@
 - Enhanced Python kernel availability checking with faster validation
 - Optimized Python environment warming to avoid blocking during tool initialization
 - Reorganized settings interface into behavior, tools, display, voice, status, lsp, and exa tabs
-- Migrated environment variables from PI* to OMP* prefix with automatic migration
+- Migrated environment variables from `PI_*` to `OMP_*` prefix with automatic migration
 - Updated model selector to use TabBar component for provider navigation
 - Changed role badges to inverted style with colored backgrounds
 - Added support for /models command alias in addition to /model

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "17.5.2",
+	"version": "18.1.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -31,27 +31,28 @@
 		"xcsh": "src/cli.ts"
 	},
 	"scripts": {
-		"build": "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",
+		"build": "bun run generate-build-info && 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 check:types",
-		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"check:types": "bun run generate-build-info && tsgo -p tsconfig.json --noEmit",
 		"lint": "biome lint .",
-		"test": "bun test --max-concurrency 4",
-		"fix": "biome check --write --unsafe . && bun run format-prompts && bun run generate-docs-index",
+		"test": "bun run generate-build-info && bun test --max-concurrency 4",
+		"fix": "biome check --write --unsafe . && bun run format-prompts && bun run generate-docs-index && bun run generate-build-info",
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
 		"generate-docs-index": "bun scripts/generate-docs-index.ts",
-		"prepack": "bun scripts/generate-docs-index.ts",
+		"generate-build-info": "bun scripts/generate-build-info.ts",
+		"prepack": "bun scripts/generate-docs-index.ts && bun scripts/generate-build-info.ts",
 		"generate-template": "bun scripts/generate-template.ts"
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "17.5.2",
-		"@f5xc-salesdemos/pi-agent-core": "17.5.2",
-		"@f5xc-salesdemos/pi-ai": "17.5.2",
-		"@f5xc-salesdemos/pi-natives": "17.5.2",
-		"@f5xc-salesdemos/pi-tui": "17.5.2",
-		"@f5xc-salesdemos/pi-utils": "17.5.2",
+		"@f5xc-salesdemos/xcsh-stats": "18.1.0",
+		"@f5xc-salesdemos/pi-agent-core": "18.1.0",
+		"@f5xc-salesdemos/pi-ai": "18.1.0",
+		"@f5xc-salesdemos/pi-natives": "18.1.0",
+		"@f5xc-salesdemos/pi-tui": "18.1.0",
+		"@f5xc-salesdemos/pi-utils": "18.1.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

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/generate-build-info.ts

@@ -0,0 +1,106 @@
+#!/usr/bin/env bun
+
+import * as path from "node:path";
+import { $ } from "bun";
+import {
+	type EnvLike,
+	resolveBranch,
+	resolveCommit,
+	resolveDirty,
+	resolvePrNumber,
+	resolveTag,
+} from "./build-info/resolvers";
+
+const repoRoot = path.resolve(import.meta.dir, "../../..");
+const outputPath = path.resolve(import.meta.dir, "../src/internal-urls/build-info.generated.ts");
+const utilsPackageJsonPath = path.resolve(repoRoot, "packages/utils/package.json");
+
+const REPO_SLUG = "f5xc-salesdemos/xcsh";
+const REPO_URL = `https://github.com/${REPO_SLUG}`;
+
+async function git(args: string[]): Promise<string> {
+	try {
+		const result = await $`git ${args}`.cwd(repoRoot).quiet();
+		return result.stdout.toString().trim();
+	} catch {
+		return "";
+	}
+}
+
+async function ghPrForSha(sha: string): Promise<string> {
+	try {
+		const result =
+			await $`gh pr list --search ${sha} --state merged --json number --limit 1 --jq ${".[0].number // empty"}`
+				.cwd(repoRoot)
+				.quiet();
+		return result.stdout.toString().trim();
+	} catch {
+		return "";
+	}
+}
+
+async function resolveCommitDate(sha: string): Promise<string> {
+	if (!sha) return "";
+	return await git(["log", "-1", "--format=%cI", sha]);
+}
+
+const env = process.env as EnvLike;
+
+const utilsPackageJson = (await Bun.file(utilsPackageJsonPath).json()) as { version: string };
+const version = utilsPackageJson.version;
+const commit = await resolveCommit(env, git);
+const shortCommit = commit ? commit.slice(0, 7) : "";
+const branch = await resolveBranch(env, git);
+const tag = await resolveTag(env, git);
+const commitDate = await resolveCommitDate(commit);
+const dirty = await resolveDirty(env, git);
+const prNumber = await resolvePrNumber(commit, env, ghPrForSha);
+const buildDate = new Date().toISOString();
+const releaseUrl = `${REPO_URL}/releases/tag/v${version}`;
+const commitUrl = commit ? `${REPO_URL}/commit/${commit}` : REPO_URL;
+
+const output = [
+	"// Auto-generated by scripts/generate-build-info.ts - DO NOT EDIT",
+	"",
+	"export interface BuildInfo {",
+	"\treadonly version: string;",
+	"\treadonly commit: string;",
+	"\treadonly shortCommit: string;",
+	"\treadonly branch: string;",
+	"\treadonly tag: string;",
+	"\treadonly commitDate: string;",
+	"\treadonly buildDate: string;",
+	"\treadonly dirty: boolean;",
+	"\treadonly prNumber: string;",
+	"\treadonly repoUrl: string;",
+	"\treadonly repoSlug: string;",
+	"\treadonly commitUrl: string;",
+	"\treadonly releaseUrl: string;",
+	"}",
+	"",
+	`export const BUILD_INFO: BuildInfo = ${JSON.stringify(
+		{
+			version,
+			commit,
+			shortCommit,
+			branch,
+			tag,
+			commitDate,
+			buildDate,
+			dirty,
+			prNumber,
+			repoUrl: REPO_URL,
+			repoSlug: REPO_SLUG,
+			commitUrl,
+			releaseUrl,
+		},
+		null,
+		"\t",
+	)};`,
+	"",
+].join("\n");
+
+await Bun.write(outputPath, output);
+console.log(
+	`Generated ${path.relative(process.cwd(), outputPath)} (v${version}, ${shortCommit || "no-commit"}, branch=${branch}${tag ? `, tag=${tag}` : ""}${dirty ? ", dirty" : ""})`,
+);

package/src/config/settings-schema.ts

@@ -438,7 +438,7 @@ export const SETTINGS_SCHEMA = {
 	defaultThinkingLevel: {
 		type: "enum",
 		values: THINKING_EFFORTS,
-		default: "high",
+		default: "xhigh",
 		ui: {
 			tab: "model",
 			label: "Thinking Level",
@@ -449,7 +449,7 @@ export const SETTINGS_SCHEMA = {
 
 	hideThinkingBlock: {
 		type: "boolean",
-		default: false,
+		default: true,
 		ui: { tab: "model", label: "Hide Thinking Blocks", description: "Hide thinking blocks in assistant responses" },
 	},
 
@@ -600,7 +600,7 @@ export const SETTINGS_SCHEMA = {
 	interruptMode: {
 		type: "enum",
 		values: ["immediate", "wait"] as const,
-		default: "immediate",
+		default: "wait",
 		ui: {
 			tab: "interaction",
 			label: "Interrupt Mode",
@@ -1165,7 +1165,7 @@ export const SETTINGS_SCHEMA = {
 
 	"todo.eager": {
 		type: "boolean",
-		default: false,
+		default: true,
 		ui: {
 			tab: "tools",
 			label: "Create Todos Automatically",
@@ -1188,7 +1188,7 @@ export const SETTINGS_SCHEMA = {
 
 	"grep.contextBefore": {
 		type: "number",
-		default: 0,
+		default: 3,
 		ui: {
 			tab: "tools",
 			label: "Grep Context Before",
@@ -1199,7 +1199,7 @@ export const SETTINGS_SCHEMA = {
 
 	"grep.contextAfter": {
 		type: "number",
-		default: 0,
+		default: 3,
 		ui: {
 			tab: "tools",
 			label: "Grep Context After",
@@ -1503,7 +1503,7 @@ export const SETTINGS_SCHEMA = {
 
 	"task.eager": {
 		type: "boolean",
-		default: false,
+		default: true,
 		ui: {
 			tab: "tasks",
 			label: "Prefer Task Delegation",
@@ -1599,7 +1599,7 @@ export const SETTINGS_SCHEMA = {
 	// Secret handling
 	"secrets.enabled": {
 		type: "boolean",
-		default: false,
+		default: true,
 		ui: { tab: "providers", label: "Hide Secrets", description: "Obfuscate secrets before sending to AI providers" },
 	},
 

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

@@ -0,0 +1,182 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { $ } from "bun";
+import { BUILD_INFO, type BuildInfo } from "./build-info.generated";
+
+export type BuildInfoSource = "compiled" | "live-git" | "embedded-fallback";
+
+export interface RuntimeBuildInfo extends BuildInfo {
+	readonly source: BuildInfoSource;
+	readonly resolvedAt: string;
+}
+
+export interface RuntimeBuildInfoDeps {
+	readonly isCompiled: boolean;
+	readonly gitAvailable: () => boolean;
+	readonly git: (args: string[]) => Promise<string>;
+	readonly now: () => Date;
+}
+
+function shortOf(sha: string): string {
+	return sha ? sha.slice(0, 7) : "";
+}
+
+function commitUrl(repoUrl: string, commit: string): string {
+	return commit ? `${repoUrl}/commit/${commit}` : repoUrl;
+}
+
+function firstRemoteBranch(output: string): string {
+	for (const raw of output.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 "";
+}
+
+async function liveBranch(git: RuntimeBuildInfoDeps["git"]): Promise<string> {
+	const abbrev = await git(["rev-parse", "--abbrev-ref", "HEAD"]);
+	if (abbrev && abbrev !== "HEAD") return abbrev;
+	const remote = await git(["branch", "-r", "--contains", "HEAD"]);
+	return firstRemoteBranch(remote);
+}
+
+export async function resolveRuntimeBuildInfo(
+	embedded: BuildInfo,
+	deps: RuntimeBuildInfoDeps,
+): Promise<RuntimeBuildInfo> {
+	const resolvedAt = deps.now().toISOString();
+
+	if (deps.isCompiled) {
+		return { ...embedded, source: "compiled", resolvedAt };
+	}
+
+	if (!deps.gitAvailable()) {
+		return { ...embedded, source: "embedded-fallback", resolvedAt };
+	}
+
+	const commit = (await deps.git(["rev-parse", "HEAD"])) || embedded.commit;
+	const branch = (await liveBranch(deps.git)) || embedded.branch;
+	const tag = await deps.git(["describe", "--exact-match", "--tags", "HEAD"]);
+	const status = await deps.git(["status", "--porcelain"]);
+	const dirty = status.length > 0;
+	const commitDate = (await deps.git(["log", "-1", "--format=%cI", "HEAD"])) || embedded.commitDate;
+
+	return {
+		version: embedded.version,
+		commit,
+		shortCommit: shortOf(commit),
+		branch,
+		tag,
+		commitDate,
+		buildDate: embedded.buildDate,
+		dirty,
+		prNumber: embedded.prNumber,
+		repoUrl: embedded.repoUrl,
+		repoSlug: embedded.repoSlug,
+		commitUrl: commitUrl(embedded.repoUrl, commit),
+		releaseUrl: embedded.releaseUrl,
+		source: "live-git",
+		resolvedAt,
+	};
+}
+
+export function renderAboutDoc(info: RuntimeBuildInfo): 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})`,
+		"",
+		"## 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}`,
+		"",
+		"## What to do when asked about xcsh itself",
+		"",
+		"1. Confirm the user is running the version above. If unsure, ask them to run `xcsh --version`.",
+		"2. Check recent changes with `gh pr list --repo f5xc-salesdemos/xcsh --base main --state merged --limit 20`",
+		"   or `git log --oneline -n 20` if you have a local clone. A fix may already be on `main`.",
+		"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 f5xc-salesdemos/xcsh --title ... --body ...`, referencing the commit above.",
+		"",
+		"## 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");
+}
+
+// Bun-embedded module URL markers. Mirrors the native addon loader
+// (see xcsh://natives-addon-loader-runtime.md) so compiled-mode detection stays
+// consistent across the codebase. Update all three in lockstep if Bun changes them.
+const COMPILED_URL_MARKERS = ["$bunfs", "~BUN", "%7EBUN"] as const;
+
+export function detectCompiledRuntime(
+	metaUrl: string,
+	env: Readonly<Record<string, string | undefined>> = {},
+): boolean {
+	if (env.PI_COMPILED) return true;
+	return COMPILED_URL_MARKERS.some(marker => metaUrl.includes(marker));
+}
+
+export function findGitRoot(startDir: string, fsExists: (p: string) => boolean = fs.existsSync): string | null {
+	let current = path.resolve(startDir);
+	while (true) {
+		if (fsExists(path.join(current, ".git"))) return current;
+		const parent = path.dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+}
+
+export function defaultRuntimeDeps(): RuntimeBuildInfoDeps {
+	const isCompiled = detectCompiledRuntime(import.meta.url, Bun.env);
+	const gitRoot = isCompiled ? null : findGitRoot(import.meta.dir);
+
+	return {
+		isCompiled,
+		gitAvailable: () => gitRoot !== null,
+		git: async (args: string[]): Promise<string> => {
+			if (!gitRoot) return "";
+			try {
+				const result = await $`git ${args}`.cwd(gitRoot).quiet();
+				return result.stdout.toString().trim();
+			} catch {
+				return "";
+			}
+		},
+		now: () => new Date(),
+	};
+}
+
+// Intentionally no cache. `xcsh://about` is invoked once per xcsh-related question
+// at agent-tool-call granularity; stale fingerprints after branch-switch / dirty-tree
+// changes would silently lie under source-mode. Re-resolving costs ~30ms of git subprocess
+// time in source mode and ~0ms in compiled mode (where we return embedded BUILD_INFO).
+export function getRuntimeBuildInfo(): Promise<RuntimeBuildInfo> {
+	return resolveRuntimeBuildInfo(BUILD_INFO, defaultRuntimeDeps());
+}

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

@@ -0,0 +1,33 @@
+// Auto-generated by scripts/generate-build-info.ts - DO NOT EDIT
+
+export interface BuildInfo {
+	readonly version: string;
+	readonly commit: string;
+	readonly shortCommit: string;
+	readonly branch: string;
+	readonly tag: string;
+	readonly commitDate: string;
+	readonly buildDate: string;
+	readonly dirty: boolean;
+	readonly prNumber: string;
+	readonly repoUrl: string;
+	readonly repoSlug: string;
+	readonly commitUrl: string;
+	readonly releaseUrl: string;
+}
+
+export const BUILD_INFO: BuildInfo = {
+	"version": "18.1.0",
+	"commit": "caf6a7fa027b863b9f421a8d8cc7cc4df2ec8136",
+	"shortCommit": "caf6a7f",
+	"branch": "main",
+	"tag": "v18.1.0",
+	"commitDate": "2026-04-20T07:08:46Z",
+	"buildDate": "2026-04-20T07:32:00.751Z",
+	"dirty": false,
+	"prNumber": "",
+	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
+	"repoSlug": "f5xc-salesdemos/xcsh",
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/caf6a7fa027b863b9f421a8d8cc7cc4df2ec8136",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.1.0"
+};