@f5xc-salesdemos/xcsh 19.38.1 → 19.40.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "19.38.1",
+	"version": "19.40.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -51,13 +51,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "19.38.1",
-		"@f5xc-salesdemos/pi-agent-core": "19.38.1",
-		"@f5xc-salesdemos/pi-ai": "19.38.1",
-		"@f5xc-salesdemos/pi-natives": "19.38.1",
-		"@f5xc-salesdemos/pi-resource-management": "19.38.1",
-		"@f5xc-salesdemos/pi-tui": "19.38.1",
-		"@f5xc-salesdemos/pi-utils": "19.38.1",
+		"@f5xc-salesdemos/xcsh-stats": "19.40.0",
+		"@f5xc-salesdemos/pi-agent-core": "19.40.0",
+		"@f5xc-salesdemos/pi-ai": "19.40.0",
+		"@f5xc-salesdemos/pi-natives": "19.40.0",
+		"@f5xc-salesdemos/pi-resource-management": "19.40.0",
+		"@f5xc-salesdemos/pi-tui": "19.40.0",
+		"@f5xc-salesdemos/pi-utils": "19.40.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

package/src/capability/context-file.ts

@@ -1,8 +1,7 @@
 /**
  * Context Files Capability
  *
- * System instruction files (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) that provide
- * persistent guidance to the agent.
+ * System instruction files (XCSH.md) that provide persistent guidance to the agent.
  */
 import * as path from "node:path";
 import { defineCapability } from ".";
@@ -27,10 +26,10 @@ export interface ContextFile {
 export const contextFileCapability = defineCapability<ContextFile>({
 	id: "context-files",
 	displayName: "Context Files",
-	description: "Persistent instruction files (CLAUDE.md, AGENTS.md, etc.) that guide agent behavior",
+	description: "Persistent instruction files (XCSH.md) that guide agent behavior",
 	// Deduplicate by scope: one user-level file, and one project-level file per directory depth.
 	// Within each depth level, higher-priority providers shadow lower-priority ones.
-	// This supports monorepo hierarchies where AGENTS.md exists at multiple ancestor levels.
+	// This supports monorepo hierarchies where XCSH.md exists at multiple ancestor levels.
 	// Clamp depth >= 0: files inside config subdirectories of an ancestor (e.g. .xcsh/, .github/)
 	// are same-scope as the ancestor itself.
 	key: file => (file.level === "user" ? "user" : `project:${Math.max(0, file.depth ?? 0)}`),

package/src/cli/chrome-cli.ts

@@ -15,7 +15,14 @@ type Settings = { get(key: string): unknown };
 
 export type ChromeAction = "status" | "relaunch" | "setup";
 
+// Unpacked (keyed) build — installed from a GitHub release. The manifest `key`
+// pins this deterministic ID.
 export const EXTENSION_ID = "khlalklompggpfnmeclpligmcbknkemg";
+// Chrome Web Store build — the store assigns this ID (no `key` field).
+export const EXTENSION_ID_CWS = "klajkjdoehjidngligegnpknogmjjhkc";
+// Both are allowed in the native-host manifest so the bridge works regardless of
+// how the user installed the extension.
+export const EXTENSION_IDS = [EXTENSION_ID, EXTENSION_ID_CWS];
 
 const NATIVE_HOST_NAME = "com.f5xc.xcsh.chrome_host";
 
@@ -29,7 +36,7 @@ export function writeNativeHostManifest(opts: {
 	platform?: NodeJS.Platform;
 	home?: string;
 	xcshBinPath: string;
-	extensionId: string;
+	extensionIds: string[];
 	write?: (p: string, c: string) => void;
 }): { manifestPath: string } {
 	const platform = opts.platform ?? process.platform;
@@ -43,7 +50,7 @@ export function writeNativeHostManifest(opts: {
 		path: opts.xcshBinPath,
 		args: ["chrome-host"],
 		type: "stdio",
-		allowed_origins: [`chrome-extension://${opts.extensionId}/`],
+		allowed_origins: opts.extensionIds.map(id => `chrome-extension://${id}/`),
 	};
 	const write =
 		opts.write ??
@@ -77,9 +84,9 @@ export async function runChromeCommand(action: ChromeAction, settings: Settings)
 	if (action === "setup") {
 		const { manifestPath } = writeNativeHostManifest({
 			xcshBinPath: process.execPath,
-			extensionId: EXTENSION_ID,
+			extensionIds: EXTENSION_IDS,
 		});
-		return `Installed native-messaging host manifest at ${manifestPath} (extension ${EXTENSION_ID}). Load the xcsh Chrome extension, then it can drive your real Chrome.`;
+		return `Installed native-messaging host manifest at ${manifestPath} (extensions ${EXTENSION_IDS.join(", ")}). Load the xcsh Chrome extension, then it can drive your real Chrome.`;
 	}
 	// relaunch: self-consented rung 3 — force allowRelaunch regardless of the setting.
 	const { mode } = await acquirePage({ settings, allowRelaunch: true });

package/src/commit/agentic/index.ts

@@ -79,7 +79,7 @@ export async function runAgenticCommit(args: CommitCommandArgs): Promise<void> {
 	}
 
 	process.stdout.write("● Discovering context files...\n");
-	const agentsMdFiles = contextFiles.filter(file => file.path.endsWith("AGENTS.md"));
+	const agentsMdFiles = contextFiles.filter(file => file.path.endsWith("XCSH.md"));
 	if (agentsMdFiles.length > 0) {
 		for (const file of agentsMdFiles) {
 			process.stdout.write(`  └─ ${file.path}\n`);

package/src/config/settings-schema.ts

@@ -231,7 +231,6 @@ export const SETTINGS_SCHEMA = {
 			"xcsh-plugins",
 			"codex",
 			"agents",
-			"agents-md",
 			"gemini",
 			"opencode",
 			"cursor",

package/src/discovery/agents-md.ts

@@ -1,9 +1,9 @@
 /**
- * AGENTS.md Provider
+ * XCSH.md Provider
  *
- * Discovers standalone AGENTS.md files by walking up from cwd.
- * This handles AGENTS.md files that live in project root (not in config directories
- * like .codex/ or .gemini/, which are handled by their respective providers).
+ * Discovers standalone XCSH.md files by walking up from cwd.
+ * This handles XCSH.md files that live in the project root (the human-editable
+ * agent init file), not in config directories.
  */
 import * as path from "node:path";
 import { registerProvider } from "../capability";
@@ -13,20 +13,20 @@ import type { LoadContext, LoadResult } from "../capability/types";
 import { calculateDepth, createSourceMeta } from "./helpers";
 
 const PROVIDER_ID = "agents-md";
-const DISPLAY_NAME = "AGENTS.md";
+const DISPLAY_NAME = "XCSH.md";
 
 /**
- * Load standalone AGENTS.md files.
+ * Load standalone XCSH.md files.
  */
 async function loadAgentsMd(ctx: LoadContext): Promise<LoadResult<ContextFile>> {
 	const items: ContextFile[] = [];
 	const warnings: string[] = [];
 
-	// Walk up from cwd looking for AGENTS.md files
+	// Walk up from cwd looking for XCSH.md files
 	let current = ctx.cwd;
 
 	while (true) {
-		const candidate = path.join(current, "AGENTS.md");
+		const candidate = path.join(current, "XCSH.md");
 		const content = await readFile(candidate);
 
 		if (content !== null) {
@@ -61,7 +61,7 @@ async function loadAgentsMd(ctx: LoadContext): Promise<LoadResult<ContextFile>>
 registerProvider(contextFileCapability.id, {
 	id: PROVIDER_ID,
 	displayName: DISPLAY_NAME,
-	description: "Standalone AGENTS.md files (Codex/Gemini style)",
+	description: "Standalone XCSH.md files (project-root agent init file)",
 	priority: 10,
 	load: loadAgentsMd,
 });

package/src/discovery/builtin.ts

@@ -808,12 +808,12 @@ registerProvider<Settings>(settingsCapability.id, {
 	load: loadSettings,
 });
 
-// Context Files (AGENTS.md)
+// Context Files (XCSH.md)
 async function loadContextFiles(ctx: LoadContext): Promise<LoadResult<ContextFile>> {
 	const items: ContextFile[] = [];
 	const warnings: string[] = [];
 
-	const userPath = path.join(ctx.home, PATHS.userAgent, "AGENTS.md");
+	const userPath = path.join(ctx.home, PATHS.userAgent, "XCSH.md");
 	const userContent = await readFile(userPath);
 	if (userContent) {
 		items.push({
@@ -826,7 +826,7 @@ async function loadContextFiles(ctx: LoadContext): Promise<LoadResult<ContextFil
 
 	const nearestProjectConfigDir = await findNearestProjectConfigDir(ctx.cwd, ctx.repoRoot);
 	if (nearestProjectConfigDir) {
-		const projectPath = path.join(nearestProjectConfigDir.dir, "AGENTS.md");
+		const projectPath = path.join(nearestProjectConfigDir.dir, "XCSH.md");
 		const projectContent = await readFile(projectPath);
 		if (projectContent) {
 			items.push({
@@ -845,7 +845,7 @@ async function loadContextFiles(ctx: LoadContext): Promise<LoadResult<ContextFil
 registerProvider<ContextFile>(contextFileCapability.id, {
 	id: PROVIDER_ID,
 	displayName: DISPLAY_NAME,
-	description: "Load AGENTS.md from .xcsh/ directories",
+	description: "Load XCSH.md from .xcsh/ directories",
 	priority: PRIORITY,
 	load: loadContextFiles,
 });

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.38.1",
-	"commit": "266202856915236a611800e70fb7eb31e6f01ddb",
-	"shortCommit": "2662028",
+	"version": "19.40.0",
+	"commit": "e25f0c5f25c2bc47d8e50a69b4ad6ac4edc7c3e5",
+	"shortCommit": "e25f0c5",
 	"branch": "main",
-	"tag": "v19.38.1",
-	"commitDate": "2026-06-22T04:47:29Z",
-	"buildDate": "2026-06-22T05:11:23.831Z",
+	"tag": "v19.40.0",
+	"commitDate": "2026-06-22T20:09:25Z",
+	"buildDate": "2026-06-22T20:31:47.773Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/266202856915236a611800e70fb7eb31e6f01ddb",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.38.1"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/e25f0c5f25c2bc47d8e50a69b4ad6ac4edc7c3e5",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.40.0"
 };