agent-transport-system 0.2.2 → 0.2.3

package/dist/ats.js

@@ -20,7 +20,66 @@ import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import WebSocket from "ws";
 
 //#region package.json
-var version$1 = "0.2.2";
+var version$1 = "0.2.3";
+var package_default = {
+	name: "agent-transport-system",
+	version: version$1,
+	atsReleaseDate: "2026-03-12",
+	description: "Agent Transport System CLI - https://ats.sh",
+	license: "MIT",
+	type: "module",
+	bin: {
+		"agent-transport-system": "dist/ats.js",
+		"ats": "dist/ats.js"
+	},
+	"private": false,
+	engines: { "node": ">=20" },
+	files: [
+		"README.md",
+		"dist",
+		"skills"
+	],
+	scripts: {
+		"build:deps": "pnpm --filter @agent-transport-system/agent-runtime build && pnpm --filter @agent-transport-system/protocol build && pnpm --filter @agent-transport-system/gateway-contract build && pnpm --filter @agent-transport-system/schemas build && pnpm --filter @agent-transport-system/adapter-core build && pnpm --filter @agent-transport-system/adapter-claude-code build && pnpm --filter @agent-transport-system/adapter-codex build && pnpm --filter @agent-transport-system/adapter-openclaw build && pnpm --filter @agent-transport-system/atsd build",
+		"prebuild": "pnpm run build:deps",
+		"build": "tsdown",
+		"prepack": "pnpm run build && pnpm run verify:pack-readme",
+		"prepublishOnly": "pnpm run verify:pack-readme",
+		"verify:pack-readme": "node scripts/verify-npm-pack-readme.mjs",
+		"pretypecheck": "pnpm run build:deps",
+		"typecheck": "tsc -p tsconfig.json --noEmit",
+		"precheck": "pnpm run build:deps",
+		"check": "ultracite check && tsc -p tsconfig.json --noEmit",
+		"pretest": "pnpm run build:deps",
+		"test": "vitest run",
+		"test:daemon": "vitest run tests/daemon-state.test.ts tests/daemon-command.test.ts tests/daemon-menu.test.ts tests/daemon-run.test.ts tests/daemon-bootstrap-recommendation.test.ts",
+		"test:watch": "vitest"
+	},
+	dependencies: {
+		"@clack/prompts": "^1.0.1",
+		"commander": "^14.0.0",
+		"picocolors": "^1.1.1",
+		"string-width": "^8.1.0",
+		"ws": "^8.18.3"
+	},
+	devDependencies: {
+		"@agent-transport-system/adapter-claude-code": "workspace:*",
+		"@agent-transport-system/adapter-codex": "workspace:*",
+		"@agent-transport-system/adapter-core": "workspace:*",
+		"@agent-transport-system/adapter-openclaw": "workspace:*",
+		"@agent-transport-system/atsd": "workspace:*",
+		"@agent-transport-system/gateway-contract": "workspace:*",
+		"@agent-transport-system/protocol": "workspace:*",
+		"@agent-transport-system/schemas": "workspace:*",
+		"@types/node": "^24.3.0",
+		"@types/ws": "^8.18.1",
+		"oxc-resolver": "^11.0.0",
+		"tsdown": "^0.20.3",
+		"typescript": "^5.9.3",
+		"unplugin-lightningcss": "^0.4.0",
+		"vitest": "~3.2.0"
+	}
+};
 
 //#endregion
 //#region ../../config/agents/registry.json
@@ -1597,6 +1656,7 @@ function buildCommandChecks(...parts) {
 	return Object.freeze(Object.assign({}, SKIP_ALL_CHECKS, ...parts));
 }
 const COMMAND_CHECK_REQUIREMENTS = Object.freeze({
+	root: buildCommandChecks(OPTIONAL_CLI_UPDATE),
 	view: buildCommandChecks(OPTIONAL_CLI_UPDATE),
 	start: buildCommandChecks(OPTIONAL_CLI_UPDATE, AUTO_FIX_LOCAL_RUNTIME),
 	"repair.local-state": buildCommandChecks(),
@@ -1662,6 +1722,7 @@ function getCommandCheckRequirements(entryName) {
 //#endregion
 //#region src/command-entry-checks/command-entry-name.ts
 const COMMAND_ENTRY_NAME_BY_ROUTE = {
+	"": "root",
 	view: "view",
 	start: "start",
 	repair: "repair.local-state",
@@ -1772,7 +1833,7 @@ function resolveCommandEntryNameFromRoute(route) {
 }
 function resolveCommandEntryNameFromTokens(tokens) {
 	const normalized = tokens.map((token) => token.trim()).filter((token) => token.length > 0).join(" ");
-	if (normalized.length === 0) return null;
+	if (normalized.length === 0) return resolveCommandEntryNameFromRoute("");
 	return resolveCommandEntryNameFromRoute(normalized);
 }
 
@@ -2026,6 +2087,22 @@ function createInitialVersionState(input) {
 function hasValidLastVersion(state) {
 	return Boolean(toNonEmptyString(state?.last_version));
 }
+async function ensureVersionStateReady(input) {
+	const previousVersionState = await readVersionState();
+	if (!previousVersionState) {
+		const nextState = createInitialVersionState({ currentVersion: input.currentVersion });
+		await writeVersionState(nextState);
+		return nextState;
+	}
+	if (hasValidLastVersion(previousVersionState)) return previousVersionState;
+	const nextState = {
+		...previousVersionState,
+		last_version: input.currentVersion,
+		latest_version: previousVersionState.latest_version ?? input.currentVersion
+	};
+	await writeVersionState(nextState);
+	return nextState;
+}
 function buildNextVersionState(input) {
 	const checkedAt = input.checkedAt ?? (/* @__PURE__ */ new Date()).toISOString();
 	const latestVersion = toNonEmptyString(input.latestVersion) ?? toNonEmptyString(input.previous?.latest_version) ?? input.currentVersion;
@@ -3921,21 +3998,16 @@ async function resolveAtsProfile(input) {
 		}
 	}), "profile"));
 }
-async function createAtsAgentProfile(input) {
+function createAtsAgentProfile(input) {
 	const profileName = normalizeOptionalString$14(input.profileName);
+	const controllerRef = normalizeOptionalString$14(input.controllerRef) ?? void 0;
 	if (!profileName) throw new Error("profile name is required");
-	const created = parseAtsProfileItem(readRecordField(await requestAtsProfilesApi({
-		method: "POST",
-		path: "/v1/profiles/agents",
-		body: {
-			profileName,
-			...input.controllerKind ? { controllerKind: input.controllerKind } : {},
-			...normalizeOptionalString$14(input.controllerRef) ? { controllerRef: normalizeOptionalString$14(input.controllerRef) } : {},
-			...typeof input.controllerEnabled === "boolean" ? { controllerEnabled: input.controllerEnabled } : {}
-		}
-	}), "profile"));
-	await emitDaemonCatalogSyncSignal$1("profile_created");
-	return created;
+	return createAtsAgentProfileRequest({
+		profileName,
+		...input.controllerKind ? { controllerKind: input.controllerKind } : {},
+		...controllerRef ? { controllerRef } : {},
+		...typeof input.controllerEnabled === "boolean" ? { controllerEnabled: input.controllerEnabled } : {}
+	});
 }
 async function createAtsHumanProfile(input) {
 	const profileName = normalizeOptionalString$14(input.profileName);
@@ -4032,6 +4104,20 @@ async function requestAtsProfilesApi(input) {
 	}
 	return record;
 }
+async function createAtsAgentProfileRequest(input) {
+	const created = parseAtsProfileItem(readRecordField(await requestAtsProfilesApi({
+		method: "POST",
+		path: "/v1/profiles/agents",
+		body: {
+			profileName: input.profileName,
+			...input.controllerKind ? { controllerKind: input.controllerKind } : {},
+			...input.controllerRef ? { controllerRef: input.controllerRef } : {},
+			...typeof input.controllerEnabled === "boolean" ? { controllerEnabled: input.controllerEnabled } : {}
+		}
+	}), "profile"));
+	await emitDaemonCatalogSyncSignal$1("profile_created");
+	return created;
+}
 async function requireAtsProfilesSession() {
 	const now = Date.now();
 	if (validatedSessionCache && now - validatedSessionCache.validatedAtMs <= VALIDATED_SESSION_CACHE_TTL_MS) {
@@ -4213,12 +4299,17 @@ function extractApiErrorMessage$1(payload, status) {
 function resolveProfilesApiErrorMessage(input) {
 	const message = extractApiErrorMessage$1(input.payload, input.status);
 	if (input.status === 500 && input.code === "profile.internal_error" && isLoopbackProfileEndpoint(input.endpoint)) return "internal error from local auth service; if profile schema changed, run `pnpm --filter @agent-transport-system/auth-worker run db:migrate:dev` and retry.";
+	if (input.status === 500 && input.code === "profile.internal_error" && isHostedProfilesEndpoint(input.endpoint)) return "internal error from ATS auth service while handling profile state. If this works in `ats-dev` but fails in `ats`, the hosted auth deployment is likely out of sync with the latest profile flow. Retry after the production auth deploy/migration is updated.";
 	return message;
 }
 function isLoopbackProfileEndpoint(endpoint) {
 	const url = parseUrlOrNull$2(endpoint);
 	return Boolean(url && isLoopbackHostname$2(url.hostname) && url.pathname.startsWith("/v1/profiles"));
 }
+function isHostedProfilesEndpoint(endpoint) {
+	const url = parseUrlOrNull$2(endpoint);
+	return Boolean(url && !isLoopbackHostname$2(url.hostname) && url.pathname.startsWith("/v1/profiles"));
+}
 function isRecord$2(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -8374,7 +8465,7 @@ var ZodFirstPartyTypeKind;
 (function(ZodFirstPartyTypeKind) {})(ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {}));
 
 //#endregion
-//#region ../../packages/schemas/dist/envelope-Bj9337Pa.js
+//#region ../../packages/schemas/dist/envelope-D05cA6vb.js
 const MAX_PROFILE_ID_LENGTH = 64;
 const MAX_PROFILE_NAME_LENGTH = 64;
 const MAX_TEXT_LENGTH$1 = 4e3;
@@ -8842,6 +8933,11 @@ function canonicalizeControllerRefForKind(input) {
 	if (input.controllerKind === "builtin") return canonicalizeBuiltinControllerRef(normalized);
 	return normalized;
 }
+function buildControllerRoutingKeyForKind(input) {
+	const canonicalControllerRef = canonicalizeControllerRefForKind(input);
+	if (!canonicalControllerRef) return null;
+	return input.controllerKind === "builtin" ? canonicalControllerRef : `${input.controllerKind}:${canonicalControllerRef}`;
+}
 function canonicalizeBuiltinControllerRef(controllerRef) {
 	const builtinId = normalizeBuiltinControllerId(controllerRef);
 	return builtinId ? `${BUILTIN_CONTROLLER_REF_PREFIX}${builtinId}` : null;
@@ -11459,6 +11555,21 @@ function canUseInteractivePrompts(context) {
 	return context.resolvedView === "human" && context.interactive;
 }
 
+//#endregion
+//#region src/runtime/manual-upgrade.ts
+const MANUAL_ATS_UPGRADE_COMMAND = "npm install -g agent-transport-system@latest";
+const ATS_UPGRADE_METADATA_RECOVERY_HINTS = [
+	MANUAL_ATS_UPGRADE_COMMAND,
+	"ats reset --yes",
+	"ats start",
+	"ats upgrade --check"
+];
+const ATS_UPGRADE_FAILURE_HINTS = [
+	MANUAL_ATS_UPGRADE_COMMAND,
+	"ats upgrade --check",
+	"ats upgrade --yes"
+];
+
 //#endregion
 //#region src/ui/io.ts
 function outLine(line) {
@@ -14310,6 +14421,98 @@ function resolveAlignmentProgressMessage(step) {
 	}
 }
 
+//#endregion
+//#region src/runtime/cli-version.ts
+const PACKAGE_JSON = package_default;
+const ISO_RELEASE_DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/u;
+function getCliVersionInfo() {
+	const version = PACKAGE_JSON.version;
+	const releaseDate = normalizeReleaseDate(PACKAGE_JSON.atsReleaseDate);
+	const releaseDateLabel = releaseDate ? formatCliReleaseDateLabel(releaseDate) : null;
+	return {
+		version,
+		releaseDate,
+		releaseDateLabel,
+		summary: formatCliVersionSummary({
+			version,
+			releaseDateLabel
+		})
+	};
+}
+function formatCliVersionSummary(input) {
+	const versionInfo = input ?? getCliVersionInfo();
+	if (!versionInfo.releaseDateLabel) return `Current version: ${versionInfo.version}`;
+	return `Current version: ${versionInfo.version} • ${versionInfo.releaseDateLabel}`;
+}
+function normalizeReleaseDate(value) {
+	const normalized = String(value ?? "").trim();
+	if (!ISO_RELEASE_DATE_RE.test(normalized)) return null;
+	return normalized;
+}
+function formatCliReleaseDateLabel(releaseDate) {
+	const match = releaseDate.match(ISO_RELEASE_DATE_RE);
+	if (!match) return releaseDate;
+	return `${match[2]}-${match[3]}`;
+}
+
+//#endregion
+//#region src/ui/root-entry-catalog.ts
+const ROOT_ENTRY_START_COMMAND = "ats start";
+const ROOT_ENTRY_COMMANDS = [
+	{
+		command: "ats start",
+		description: "Initialize your identity"
+	},
+	{
+		command: "ats auth",
+		description: "Sign in, sign out, and inspect auth state"
+	},
+	{
+		command: "ats profiles",
+		description: "Manage ATS profiles"
+	},
+	{
+		command: "ats agents",
+		description: "Manage ATS agent targets and bindings"
+	},
+	{
+		command: "ats view human|agent",
+		description: "Switch default view mode"
+	},
+	{
+		command: "ats space",
+		description: "Create, join, and configure spaces"
+	},
+	{
+		command: "ats skills",
+		description: "Install or list ATS skills"
+	},
+	{
+		command: "ats service",
+		description: "Manage ATS background service"
+	},
+	{
+		command: "ats whoami",
+		description: "Show your current identity"
+	},
+	{
+		command: "ats doctor",
+		description: "Check local setup and connectivity"
+	},
+	{
+		command: "ats upgrade",
+		description: "Upgrade ATS CLI when a new version is available"
+	},
+	{
+		command: "ats reset",
+		description: "Reset local ATS state and reinitialize baseline files"
+	},
+	{
+		command: "ats help (-h, --help)",
+		description: "Show help for a command"
+	}
+];
+
 //#endregion
 //#region src/commands/top-level-agent-overview.ts
 function emitTopLevelAgentOverview(input) {
@@ -14327,6 +14530,23 @@ function emitTopLevelCliAgentOverview(command) {
 }
 function buildTopLevelAgentOverviewPayload(command) {
 	switch (command) {
+		case "root": return {
+			summary: "Show the ATS root entry menu, recommend `ats start`, and expose the current CLI release metadata.",
+			requiredArguments: [],
+			optionalArguments: [],
+			commands: ROOT_ENTRY_COMMANDS.map((item) => item.command),
+			stages: [
+				"Recommend the first onboarding command.",
+				"List the top-level ATS commands available from the root entry.",
+				"Return the currently installed CLI version and release date."
+			],
+			notes: ["Human view renders the branded banner; agent view receives this structured root overview."],
+			cli: getCliVersionInfo(),
+			humanActionRequired: {
+				possible: false,
+				steps: []
+			}
+		};
 		case "view": return {
 			summary: "Inspect or save the default ATS view mode for the current or explicit ATS profile.",
 			requiredArguments: [],
@@ -14585,13 +14805,14 @@ async function runUpgrade(input) {
 	});
 }
 function handleMissingVersionMetadata(input) {
-	const errorMessage = formatInlineAtsCliCommands("ATS version metadata is missing; run `ats reset --yes` before `ats upgrade`.");
+	const errorMessage = formatAtsCliTextBlock(`ATS version metadata is missing, so automatic upgrade cannot continue.\nManual fallback: \`${MANUAL_ATS_UPGRADE_COMMAND}\`\nIf you want to repair local ATS state first, run \`ats reset --yes\` before \`ats upgrade\`.`);
 	if (input.resolvedView === "agent") {
 		input.presenter.data({
 			code: "upgrade.metadata.missing",
 			payload: {
-				summary: "Local ATS version metadata is missing, so upgrade cannot verify downgrade safety.",
+				summary: "Local ATS version metadata is missing, so automatic upgrade cannot verify downgrade safety.",
 				nextSteps: [
+					MANUAL_ATS_UPGRADE_COMMAND,
 					"ats-dev reset --yes --view agent",
 					"ats-dev start",
 					"ats-dev upgrade --check --view agent"
@@ -14604,13 +14825,17 @@ function handleMissingVersionMetadata(input) {
 	throw new Error(errorMessage);
 }
 function handleUpgradeCheckFailure(input) {
-	const errorMessage = `Version check failed (${input.upgradeStatus.error}). Upgrade stopped because downgrade protection requires confirming that npm latest is newer than the current CLI.`;
+	const errorMessage = formatAtsCliTextBlock(`Version check failed (${input.upgradeStatus.error}). Upgrade stopped because downgrade protection requires confirming that npm latest is newer than the current CLI.\nManual fallback: \`${MANUAL_ATS_UPGRADE_COMMAND}\``);
 	if (input.resolvedView === "agent") {
 		input.presenter.data({
 			code: "upgrade.check_failed",
 			payload: {
 				...input.upgradeStatus,
-				nextSteps: ["ats-dev upgrade --check --view agent", "ats-dev upgrade --yes --view agent"],
+				nextSteps: [
+					MANUAL_ATS_UPGRADE_COMMAND,
+					"ats-dev upgrade --check --view agent",
+					"ats-dev upgrade --yes --view agent"
+				],
 				humanActionRequired: false
 			}
 		});
@@ -14670,7 +14895,7 @@ async function installLatestPackage() {
 		const stderr = result.stderr.trim();
 		const stdout = result.stdout.trim();
 		const details = stderr || stdout;
-		throw new Error(`upgrade failed (exit ${result.code})${details ? `: ${details}` : ""}`);
+		throw new Error(formatAtsCliTextBlock(`upgrade failed (exit ${result.code})${details ? `: ${details}` : ""}\nManual fallback: \`${MANUAL_ATS_UPGRADE_COMMAND}\``));
 	}
 }
 async function runInternalUpgradeServiceAlignment(input) {
@@ -14919,7 +15144,7 @@ function emitUpgradeInstalling(input) {
 	if (input.resolvedView === "agent") {
 		input.presenter.data({
 			code: "upgrade.installing",
-			payload: { command: "npm install -g agent-transport-system@latest" }
+			payload: { command: MANUAL_ATS_UPGRADE_COMMAND }
 		});
 		return;
 	}
@@ -14972,6 +15197,13 @@ const DEFAULT_COPY = {
 	serviceAction: null
 };
 const COMMAND_ENTRY_COPY_BY_NAME = Object.freeze({
+	root: {
+		...DEFAULT_COPY,
+		signInAction: null,
+		profileAction: null,
+		cliUpdateAction: "opening ATS",
+		serviceAction: null
+	},
 	view: {
 		...DEFAULT_COPY,
 		signInAction: null,
@@ -15544,6 +15776,7 @@ async function runCliUpdateCheck(input) {
 		return { status: "cancelled" };
 	}
 	if (!selected) return { status: "continue" };
+	await ensureVersionStateReady({ currentVersion });
 	await runUpgrade({
 		yes: true,
 		view: input.context.runtime.resolvedView
@@ -26067,7 +26300,17 @@ function resolveDispatchQueueLogMeta(input) {
 function buildDispatchControllerKey(input) {
 	const normalizedControllerKind = typeof input.controllerKind === "string" ? input.controllerKind.trim() : "";
 	const normalizedControllerRef = typeof input.controllerRef === "string" ? input.controllerRef.trim() : "";
-	if (normalizedControllerKind && normalizedControllerRef) return `${normalizedControllerKind}:${normalizedControllerRef}`;
+	if (normalizedControllerKind && normalizedControllerRef) {
+		if (normalizedControllerKind === "builtin" || normalizedControllerKind === "custom") {
+			const controllerKey = buildControllerRoutingKeyForKind({
+				controllerKind: normalizedControllerKind,
+				controllerRef: normalizedControllerRef
+			});
+			if (controllerKey) return controllerKey;
+			return `profile:${input.profileId}`;
+		}
+		return `${normalizedControllerKind}:${normalizedControllerRef}`;
+	}
 	return `profile:${input.profileId}`;
 }
 function resolveDispatchContinuityObservation(input) {
@@ -39983,22 +40226,8 @@ async function bootstrapAtsHome(input) {
 		...previousSkillsConfig?.customTargets ? { customTargets: previousSkillsConfig.customTargets } : {},
 		installs: previousSkillsConfig?.installs ?? []
 	});
-	const previousVersionState = await readVersionState();
-	let versionState;
-	if (!previousVersionState) {
-		versionState = createInitialVersionState({ currentVersion: input.currentVersion });
-		await writeVersionState(versionState);
-	} else if (hasValidLastVersion(previousVersionState)) versionState = previousVersionState;
-	else {
-		versionState = {
-			...previousVersionState,
-			last_version: input.currentVersion,
-			latest_version: previousVersionState.latest_version ?? input.currentVersion
-		};
-		await writeVersionState(versionState);
-	}
 	return {
-		versionState,
+		versionState: await ensureVersionStateReady({ currentVersion: input.currentVersion }),
 		skills
 	};
 }
@@ -40598,63 +40827,9 @@ const ATS_LOGO_LINES = [
 ];
 const ATS_SUBTITLE_LINES = ["AGENT TRANSPORT SYSTEM CLI • https://ats.sh", "Connect with any AI agents & humans in realtime."];
 const ATS_CLI_NPX_COMMAND = "npx agent-transport-system";
-const START_CALL_TO_ACTION_COMMAND = "ats start";
 const GLOBAL_INSTALL_COMMAND = "npm install -g agent-transport-system";
 const GLOBAL_INSTALL_SHORTCUT_COMMAND = "ats start";
-const BANNER_COMMANDS = [
-	{
-		command: "ats start",
-		description: "Initialize your identity"
-	},
-	{
-		command: "ats auth",
-		description: "Sign in, sign out, and inspect auth state"
-	},
-	{
-		command: "ats profiles",
-		description: "Manage ATS profiles"
-	},
-	{
-		command: "ats agents",
-		description: "Manage ATS agent targets and bindings"
-	},
-	{
-		command: "ats view human|agent",
-		description: "Switch default view mode"
-	},
-	{
-		command: "ats space",
-		description: "Create, join, and configure spaces"
-	},
-	{
-		command: "ats skills",
-		description: "Install or list ATS skills"
-	},
-	{
-		command: "ats service",
-		description: "Manage ATS background service"
-	},
-	{
-		command: "ats whoami",
-		description: "Show your current identity"
-	},
-	{
-		command: "ats doctor",
-		description: "Check local setup and connectivity"
-	},
-	{
-		command: "ats upgrade",
-		description: "Upgrade ATS CLI when a new version is available"
-	},
-	{
-		command: "ats reset",
-		description: "Reset local ATS state and reinitialize baseline files"
-	},
-	{
-		command: "ats help (-h, --help)",
-		description: "Show help for a command"
-	}
-];
+const CURRENT_VERSION_PREFIX = "Current version:";
 function renderAtsLogo() {
 	const useColor = pc.isColorSupported;
 	return scaleMonospaceBlock(ATS_LOGO_LINES, LOGO_SCALE).map((line, index) => {
@@ -40666,18 +40841,22 @@ function renderAtsHeader() {
 	return `${renderAtsLogo()}\n${renderAtsTagline()}`;
 }
 function printAtsBanner() {
-	const startCallToAction = `${pc.dim("Try this first:")} ${pc.bold(pc.cyan(formatAtsCliCommand(START_CALL_TO_ACTION_COMMAND)))}`;
+	const startCallToAction = `${pc.dim("Try this first:")} ${pc.bold(pc.cyan(formatAtsCliCommand(ROOT_ENTRY_START_COMMAND)))}`;
+	const versionSummary = formatCliVersionSummary();
+	const versionCallout = versionSummary.startsWith(CURRENT_VERSION_PREFIX) ? `${pc.dim(CURRENT_VERSION_PREFIX)}${versionSummary.slice(16)}` : versionSummary;
 	outLine("");
 	outLine(renderAtsLogo());
 	outLine(renderAtsTagline());
 	outLine("");
+	for (const line of renderThinCalloutBox(versionCallout)) outLine(line);
+	outLine("");
 	for (const line of renderThinCalloutBox(startCallToAction)) outLine(line);
 	if (shouldRenderGlobalInstallHint()) {
 		outLine("");
 		for (const line of renderThinCalloutBox(buildGlobalInstallHintLines())) outLine(line);
 	}
 	outLine("");
-	for (const item of BANNER_COMMANDS) outLine(`  ${pc.dim("$")} ${pc.cyan(formatAtsCliCommand(item.command))} ${pc.dim(item.description)}`);
+	for (const item of ROOT_ENTRY_COMMANDS) outLine(`  ${pc.dim("$")} ${pc.cyan(formatAtsCliCommand(item.command))} ${pc.dim(item.description)}`);
 	outLine("");
 }
 function renderAtsTagline() {
@@ -46085,6 +46264,15 @@ async function runSpaceCreate(input) {
 			resolvedView: contextRuntime.resolvedView,
 			passwordProtected: typeof createInput.value.password === "string"
 		});
+		await syncProfileSpaceHistoryForCreate({
+			atsProfile,
+			baseUrl,
+			spaceId: parsed.spaceId,
+			meta: parsed.meta,
+			fallbackSpaceName: createInput.value.name
+		}).catch((error) => {
+			contextPresenter.event("info", "connect.warn.profile_space_history_sync_failed", { error: toErrorMessage$1(error) });
+		});
 		if (!(isHumanInteractiveSpaceRuntime(contextRuntime) ? Boolean(createInput.value.joinInput) : await resolveJoinAfterCreate(createInput.value.joinInput, contextInteractive))) return;
 		await runSpaceJoin({
 			profile: atsProfile.atsProfileId,
@@ -46110,6 +46298,29 @@ async function runSpaceCreate(input) {
 		throw error;
 	}
 }
+async function syncProfileSpaceHistoryForCreate(input) {
+	const gatewayHost = resolveGatewayHost(input.baseUrl);
+	if (!gatewayHost) return;
+	const normalizedMeta = input.meta ? normalizeMetaForHistory(input.meta) : null;
+	const fallbackSpaceName = normalizeOptionalString$2(input.fallbackSpaceName);
+	const historySpaceName = normalizedMeta?.spaceName !== void 0 ? normalizedMeta.spaceName : fallbackSpaceName;
+	await upsertProfileSpaceHistory({
+		baseUrl: input.baseUrl,
+		atsProfileId: input.atsProfile.atsProfileId,
+		profileName: input.atsProfile.profileName,
+		spaceId: input.spaceId,
+		body: {
+			gatewayHost,
+			...historySpaceName ? { spaceName: historySpaceName } : {},
+			...normalizedMeta?.creatorProfileId !== void 0 ? { creatorProfileId: normalizedMeta.creatorProfileId } : { creatorProfileId: input.atsProfile.atsProfileId },
+			...normalizedMeta?.creatorKind !== void 0 ? { creatorKind: normalizedMeta.creatorKind } : { creatorKind: input.atsProfile.profileKind },
+			...normalizedMeta?.spaceCreatedAt !== void 0 ? { spaceCreatedAt: normalizedMeta.spaceCreatedAt } : {},
+			...normalizedMeta?.spaceUpdatedAt !== void 0 ? { spaceUpdatedAt: normalizedMeta.spaceUpdatedAt } : {},
+			lastJoinedAt: normalizedMeta?.spaceCreatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+			status: "active"
+		}
+	});
+}
 async function resolveSpaceCreateInput(input) {
 	if (isHumanInteractiveSpaceRuntime(input.runtime)) {
 		const prompted = await promptInteractiveSpaceCreateFlow({
@@ -49853,9 +50064,8 @@ async function resolveOwnerScopedKnownSpacesForSelection(input) {
 	});
 	if (ownedProfiles.length === 0) return null;
 	const ownedProfilesById = buildKnownSpaceProfileMap(ownedProfiles);
-	const merged = /* @__PURE__ */ new Map();
-	for (const profile of ownedProfiles) {
-		const options = await resolveKnownSpacesForSelectionByProfile({
+	const ownerScopedOptions = await Promise.all(ownedProfiles.map(async (profile) => {
+		return await resolveKnownSpacesForSelectionByProfile({
 			atsProfile: profile,
 			baseUrl: input.baseUrl,
 			command: input.command,
@@ -49863,6 +50073,9 @@ async function resolveOwnerScopedKnownSpacesForSelection(input) {
 			ownedProfilesById,
 			bestEffort: profile.atsProfileId !== input.atsProfile.atsProfileId
 		});
+	}));
+	const merged = /* @__PURE__ */ new Map();
+	for (const options of ownerScopedOptions) {
 		if (!options) continue;
 		for (const item of options) {
 			const key = normalizeKnownSpaceMergeKey(item.space);
@@ -55620,7 +55833,7 @@ async function main() {
 			return;
 		}
 		if (argv.length <= 2) {
-			printAtsBanner();
+			await runRootCommand();
 			return;
 		}
 		if (isStandaloneViewQueryArgv(argv)) {
@@ -55681,6 +55894,33 @@ async function main() {
 		process.exitCode = 1;
 	}
 }
+async function runRootCommand() {
+	const runtime = await resolveRuntimeContext();
+	const presenter = createPresenter(runtime);
+	if (runtime.resolvedView === "agent") emitTopLevelAgentOverview({
+		presenter,
+		command: "root"
+	});
+	startCurrentCommandCheckScope();
+	try {
+		const result = await runCommandEntryFlow({
+			entryName: "root",
+			argv: process.argv,
+			runtime,
+			presenter,
+			allowPrompt: runtime.interactive,
+			gatewayUrl: null,
+			profileArg: null
+		});
+		if (result.status === "continue") {
+			if (runtime.resolvedView !== "agent") printAtsBanner();
+			return;
+		}
+		if (result.status === "blocked") process.exitCode = result.exitCode;
+	} finally {
+		finishCurrentCommandCheckScope();
+	}
+}
 async function shouldPrintTagline(argv, effectiveView) {
 	if ((effectiveView === "auto" ? (await resolveRuntimeContext({ view: "auto" })).resolvedView : effectiveView) === "agent") return false;
 	const token = parseFirstCommandTokenFromArgv(argv);
@@ -56056,11 +56296,9 @@ function resolveCommonHintByMessage(message) {
 		`ats skills uninstall --agent ${DEFAULT_AGENT_EXAMPLE_PAIR}`,
 		"ats skills uninstall --dir /Users/<you>/.your-agent/skills"
 	];
-	if (message.includes("ATS version metadata is missing")) return [
-		"ats reset --yes",
-		"ats start",
-		"ats upgrade --check"
-	];
+	if (message.includes("ATS version metadata is missing")) return [...ATS_UPGRADE_METADATA_RECOVERY_HINTS];
+	if (message.includes("Version check failed (")) return [...ATS_UPGRADE_FAILURE_HINTS];
+	if (message.includes("upgrade failed (exit")) return [...ATS_UPGRADE_FAILURE_HINTS];
 	if (message.includes("ats reset requires --yes in non-interactive mode")) return ["ats reset --yes"];
 	if (message.includes("ats upgrade requires --yes in non-interactive mode")) return ["ats upgrade --yes", "ats upgrade --check"];
 	if (message.includes("interactive menu is disabled in agent view")) return [