agent-transport-system 0.6.7 → 0.6.8

package/dist/ats.js

@@ -27,7 +27,7 @@ import wrapAnsi from "wrap-ansi";
 import { Box, Container, Editor, Key, ProcessTerminal, TUI, Text, getEditorKeybindings, matchesKey } from "@mariozechner/pi-tui";
 
 //#region package.json
-var version = "0.6.7";
+var version = "0.6.8";
 var package_default = {
 	$schema: "https://www.schemastore.org/package.json",
 	name: "agent-transport-system",
@@ -24304,8 +24304,7 @@ function buildDaemonServiceRefreshHandoffMessage() {
 	return `${DAEMON_SERVICE_REFRESH_SUMMARY} Run \`${formatDaemonServiceRefreshCommand()}\` in human view, then return to ATS Web.`;
 }
 function buildDaemonServiceRefreshNextStep() {
-	const stoppedFollowUp = `If ATS Service is still stopped after repair, run \`${formatDaemonServiceStartCommand()}\`.`;
-	return `${DAEMON_SERVICE_REFRESH_SUMMARY} Run \`${formatDaemonServiceRefreshCommand()}\`. ${stoppedFollowUp}`;
+	return `${DAEMON_SERVICE_REFRESH_SUMMARY} Run \`${formatDaemonServiceRefreshCommand()}\`. If Wake or readiness still looks wrong after repair, run \`${formatDaemonServiceStatusCommand()}\`.`;
 }
 function buildDaemonServiceStatusReadOnlyDetail() {
 	return "Status is read-only. It does not change ATS Service.";
@@ -24341,6 +24340,10 @@ function formatDaemonServiceStartCommand() {
 	const [startCommand] = formatAtsCliCommands(["ats service start"]);
 	return startCommand;
 }
+function formatDaemonServiceStatusCommand() {
+	const [statusCommand] = formatAtsCliCommands(["ats service status"]);
+	return statusCommand;
+}
 
 //#endregion
 //#region src/system/service-readiness-resolver.ts
@@ -36358,6 +36361,14 @@ function normalizeOptionalText$2$1(value) {
 	const normalized = typeof value === "string" ? value.trim() : "";
 	return normalized.length > 0 ? normalized : null;
 }
+const ATS_AGENT_MENTAL_MODEL_LINES = [
+	"ATS is the Agent Transport System: a user wakes an Agent Profile in a Space, the correct local ATS Service carries the local run, and the Space shows a visible reply or an explicit visible failure.",
+	"A Space is the shared collaboration surface; an Agent Profile is the AI teammate identity; ATS Service is the local execution carrier, not the Space truth, profile identity, readiness authority, or final outcome owner.",
+	"Default Collaboration mode keeps private agent work local. Publish the public outcome through ATS Space Action; raw or transparent context sharing is explicit opt-in."
+];
+function buildAgentFacingMentalModelLines() {
+	return [...ATS_AGENT_MENTAL_MODEL_LINES];
+}
 const STRUCTURED_ACTION_BLOCK_INFO_STRING = "ats-space-action";
 const STRUCTURED_ACTION_BLOCK_RE = /(?:\r?\n)?```ats-space-action\s*\r?\n([\s\S]*?)\r?\n```\s*$/;
 const STRUCTURED_ACTION_BLOCK_LINE_BREAK_RE = /\r?\n/u;
@@ -36788,7 +36799,7 @@ function areAllowedActionsEquivalent(left, right) {
 	return canonicalLeft.length === canonicalRight.length && canonicalLeft.every((action, index) => action === canonicalRight[index]);
 }
 const COLLABORATION_HOW_THIS_SPACE_WORKS = "ATS is an external collaboration layer, not your private scratchpad. Work normally in your local context, then publish only the public outcome this Space needs with one ATS Space Action.";
-const COLLABORATION_ACTION_REQUIREMENT = "Final outcome: use exactly one ATS Space Action. Prefer the CLI command; fall back to one trailing ats-space-action block only if the CLI command is unavailable.";
+const COLLABORATION_ACTION_REQUIREMENT = "Final outcome: use exactly one ATS Space Action through the CLI. Only if every Space Action CLI command fails, use one trailing ats-space-action block.";
 const COLLABORATION_REPAIR_REQUIREMENT = "Return the corrected final answer again, preserve the user's intent, and end with exactly one valid trailing ```ats-space-action``` JSON block.";
 const RAW_CONTEXT_SHARING_HOW_THIS_SPACE_WORKS = "This Space uses transparent context sharing: ATS may share your raw reply directly. Use ATS Space Action when you need a controlled visible outcome.";
 const RAW_CONTEXT_SHARING_ACTION_REQUIREMENT = "Raw reply is allowed. Use ATS Space Action only when you need a controlled visible outcome.";
@@ -36910,7 +36921,7 @@ function buildDispatchReplyContextSummary(replyToSnapshot) {
 
 //#endregion
 //#region src/daemon/dispatch/parse-dispatch-task.ts
-const ATS_SPACE_DEFINITION = "ATS Space is an external collaboration layer where humans and Agent Profiles coordinate work without mirroring private agent context.";
+const ATS_SPACE_DEFINITION = buildAgentFacingMentalModelLines().slice(0, 2).join(" ");
 const ENTRY_BRIEF_TEMPLATE_VERSION = "space-mesh-entry-brief-v1";
 const COMPACT_DISPATCH_BOOTSTRAP_TEMPLATE_VERSION = ENTRY_BRIEF_TEMPLATE_VERSION;
 const DEFAULT_SPACE_PURPOSE = "shared coordination";
@@ -37195,7 +37206,8 @@ function buildSendTargetReferenceLines(input) {
 function buildIfUnsureLine(input) {
 	return [
 		`Need context? Run \`${buildSpaceHistoryCommand(input)}\`.`,
-		`Need action help? Run \`${buildSpaceActionCommand(input, "help")}\`, \`${buildSpaceActionCommand(input, "targets")}\`, or \`${buildPromptSpaceActionCommand(input)}\`.`,
+		`Need action help? Run \`${buildSpaceActionCommand(input, "help")}\` or \`${buildSpaceActionCommand(input, "targets")}\`.`,
+		`Fallback JSON is last resort: only if every Space Action command fails, run \`${buildPromptSpaceActionCommand(input)}\`.`,
 		"Still unclear? Ask one short question."
 	].join(" ");
 }
@@ -45185,7 +45197,7 @@ function isDaemonRunAlreadyRunningReason(reason) {
 }
 function createDaemonAlreadyRunningResult() {
 	return {
-		ok: false,
+		ok: true,
 		reason: LEGACY_DAEMON_RUN_ALREADY_RUNNING_REASON
 	};
 }
@@ -47641,7 +47653,6 @@ async function runDaemonRunInteractivePreflightBeforeModePrompt(input) {
 	const { runtimeStatus, effectiveRuntimeStatus } = await readCurrentDaemonRuntimeContext();
 	if (effectiveRuntimeStatus === "running") {
 		emitDaemonAlreadyRunningState(input.runtime, input.presenter, runtimeStatus);
-		process.exitCode = 1;
 		return createDaemonAlreadyRunningResult();
 	}
 	const authReadiness = await resolveDaemonRunAuthReadiness({ gatewayUrl: input.input.gatewayUrl });
@@ -48282,7 +48293,7 @@ async function executeDaemonRunWithJournal(input) {
 }
 function summarizeDaemonRunJournalResult(result) {
 	return {
-		result: result.ok ? "started" : result.reason,
+		result: result.reason,
 		metadata: { ok: result.ok }
 	};
 }
@@ -48418,7 +48429,6 @@ async function runSystemDaemonCore(context) {
 	const { runtimeStatus, effectiveRuntimeStatus } = await readCurrentDaemonRuntimeContext();
 	if (effectiveRuntimeStatus === "running") {
 		emitDaemonAlreadyRunningState(runtime, presenter, runtimeStatus);
-		process.exitCode = 1;
 		return createDaemonAlreadyRunningResult();
 	}
 	if (runtimeStatus.status === "stale") await clearDaemonServiceRuntimeState();
@@ -48875,11 +48885,16 @@ function resolveDaemonContractServiceController(input) {
 	return null;
 }
 function emitDaemonAlreadyRunningState(runtime, presenter, runtimeStatus) {
+	const statusCommand = formatAtsCliCommand("ats service status");
+	const guidance = `ATS Service is already running. If Wake or readiness still looks wrong, \`ats service start\` is not the repair step. Run \`${statusCommand}\`; if local participation is unhealthy, run \`${formatAtsCliCommand("ats service repair")}\` or use Check this computer in ATS Web.`;
 	if (runtime.resolvedView === "agent") {
 		presenter.data({
 			code: "daemon.run.already_running",
 			payload: {
-				ok: false,
+				ok: true,
+				guidance,
+				lifecycleState: "running",
+				nextSteps: [statusCommand],
 				reason: LEGACY_DAEMON_RUN_ALREADY_RUNNING_REASON,
 				status: runtimeStatus
 			}
@@ -48900,8 +48915,12 @@ function emitDaemonAlreadyRunningState(runtime, presenter, runtimeStatus) {
 				value: runtimeStatus.pid === null ? "not available" : String(runtimeStatus.pid)
 			},
 			{
-				label: "💡 Action",
-				value: "run `ats service stop` first, then try `ats service start` again."
+				label: "💡 What this means",
+				value: "ATS Service is already running."
+			},
+			{
+				label: "🔧 Next",
+				value: guidance
 			}
 		])
 	});
@@ -51600,6 +51619,7 @@ async function tryCreateSymlink(input) {
 //#endregion
 //#region src/skills/legacy-audit.ts
 const LEGACY_ATS_SKILL_IDS = new Set(["ats-cli-guide"]);
+const LEGACY_ATS_SKILL_VERIFICATION_COMMAND = "ats skills check --view agent";
 async function detectLegacyAtsSkillCopies(input) {
 	const currentSkillIds = new Set(input.localSkills.map((skill) => skill.id));
 	const roots = resolveCandidateSkillRoots(input);
@@ -51652,8 +51672,10 @@ async function inspectPotentialLegacyAtsSkill(input) {
 		parentDir,
 		reasonCode: "legacy_ats_skill_id",
 		problem: "This is an old ATS skill name. Agents can still load it and learn stale ATS instructions.",
-		recommendation: "Install the current ATS skill into this skill root, then remove or rename this legacy skill directory.",
-		cleanupCommands: buildLegacySkillCleanupCommands(skillDir)
+		recommendation: "Do not load or follow this skill. Install the current ATS skill into this skill root, then remove or rename this legacy skill directory and rerun the ATS skills check.",
+		currentInstallCommand: buildCurrentSkillInstallCommand(parentDir),
+		cleanupCommands: buildLegacySkillCleanupCommands(skillDir),
+		verificationCommand: LEGACY_ATS_SKILL_VERIFICATION_COMMAND
 	};
 	if (input.currentSkillIds.has(input.skillId) && !input.targetCurrentSkillDirs.has(skillDir) && isLikelyAtsSkillDocument(rawSkill)) return {
 		skillId: input.skillId,
@@ -51661,13 +51683,18 @@ async function inspectPotentialLegacyAtsSkill(input) {
 		parentDir,
 		reasonCode: "unmanaged_current_ats_skill_copy",
 		problem: "This looks like an ATS skill copy, but this ATS installation does not manage it.",
-		recommendation: "Replace it through ats skills ensure for that skill root, or remove it if this agent should not use ATS.",
-		cleanupCommands: buildLegacySkillCleanupCommands(skillDir)
+		recommendation: "Do not load or follow this unmanaged copy until the current ATS-managed skill is installed for this skill root. Install the current skill, then remove or rename this directory if this agent should not use the unmanaged copy.",
+		currentInstallCommand: buildCurrentSkillInstallCommand(parentDir),
+		cleanupCommands: buildLegacySkillCleanupCommands(skillDir),
+		verificationCommand: LEGACY_ATS_SKILL_VERIFICATION_COMMAND
 	};
 	return null;
 }
 function buildLegacySkillCleanupCommands(skillDir) {
-	return [`rm -rf ${quoteShellArg(skillDir)}`, `mv ${quoteShellArg(skillDir)} ${quoteShellArg(`${skillDir}.legacy`)}`];
+	return [`mv ${quoteShellArg(skillDir)} ${quoteShellArg(`${skillDir}.legacy`)}`, `rm -rf ${quoteShellArg(skillDir)}`];
+}
+function buildCurrentSkillInstallCommand(parentDir) {
+	return `ats skills ensure --dir ${quoteShellArg(parentDir)} --view agent`;
 }
 function quoteShellArg(value) {
 	return `'${value.replace(/'/g, "'\\''")}'`;
@@ -51915,6 +51942,7 @@ async function runSkillsCheck$1(input) {
 		localSkills,
 		targets: checkTargets
 	});
+	const payloadLegacyFindings = runtime.resolvedView === "agent" ? formatLegacyAtsSkillFindingsForAgentView(legacyFindings) : legacyFindings;
 	await persistDetectedInstallStateFromCheck({ states });
 	const summary = summarizeSkillState(states);
 	const targetStates = summarizeSkillsCheckTargets({
@@ -51929,9 +51957,9 @@ async function runSkillsCheck$1(input) {
 		summary,
 		states,
 		targetStates,
-		legacyFindings,
-		legacyFindingCount: legacyFindings.length,
-		legacyReview: legacyFindings.length > 0 ? buildLegacyAtsSkillAgentReview(legacyFindings) : null,
+		legacyFindings: payloadLegacyFindings,
+		legacyFindingCount: payloadLegacyFindings.length,
+		legacyReview: payloadLegacyFindings.length > 0 ? buildLegacyAtsSkillAgentReview(payloadLegacyFindings) : null,
 		requiresReview: summary.outdated > 0 || summary.missing > 0 || summary.externalConflict > 0 || legacyFindings.length > 0
 	};
 	if (runtime.resolvedView === "agent" && !input.suppressAgentOverview) emitSkillsAgentOverview({
@@ -51949,7 +51977,7 @@ async function runSkillsCheck$1(input) {
 	if (input.quiet) return "completed";
 	if (runtime.resolvedView === "agent") {
 		emitLegacyAtsSkillAgentAttention({
-			legacyFindings,
+			legacyFindings: payloadLegacyFindings,
 			presenter,
 			source: "skills.check"
 		});
@@ -53400,30 +53428,62 @@ function emitLegacyAtsSkillFindingsHumanCard(input) {
 }
 function buildLegacyAtsSkillNextStepRows(legacyFindings) {
 	if (legacyFindings.length === 0) return [];
+	const installCommands = buildLegacyAtsSkillInstallCommands(legacyFindings).map((command) => formatAtsCliCommand(command));
+	const verificationCommand = formatAtsCliCommand(legacyFindings[0]?.verificationCommand ?? "ats skills check --view agent");
 	return [{
 		label: "legacy ATS skills",
-		value: pc.bold(formatInlineAtsCliCommands("Remove or rename the listed legacy ATS skill directories after installing the current skill with `ats skills ensure --all --view agent` or `ats skills ensure --dir <absolute-path> --view agent`."))
+		value: pc.bold([
+			"Do not read the listed legacy ATS skill instructions.",
+			`Run ${formatInlineCommandList(installCommands)} for each affected skill root.`,
+			"After the install succeeds, rename or remove the legacy directories.",
+			`Then rerun \`${verificationCommand}\`.`
+		].join(" "))
 	}];
 }
+function formatLegacyAtsSkillFindingsForAgentView(legacyFindings) {
+	return legacyFindings.map((finding) => ({
+		...finding,
+		currentInstallCommand: formatAtsCliCommand(finding.currentInstallCommand),
+		verificationCommand: formatAtsCliCommand(finding.verificationCommand)
+	}));
+}
 function buildLegacyAtsSkillAgentReview(legacyFindings) {
+	const installCommands = buildLegacyAtsSkillInstallCommands(legacyFindings);
+	const verificationCommand = legacyFindings[0]?.verificationCommand ?? "ats skills check --view agent";
 	return {
 		priority: "high",
 		reason: "Legacy or unmanaged ATS skill copies can make agents read old ATS instructions even when the current ATS-managed skill is up to date.",
-		nextStep: "Install the current ATS skill first, then remove or rename each listed legacy directory.",
+		nextStep: "Do not read or follow the listed legacy ATS skill instructions. Run each install command, then remove or rename each listed legacy directory, then rerun the ATS skills check.",
+		nextActions: [
+			"Do not read or follow instructions from the listed legacy ATS skill directories.",
+			...installCommands.map((command) => `Run ${command}.`),
+			"After the current ATS skill install succeeds for that root, rename or remove each listed legacy directory. Prefer mv ... .legacy when you need reversible cleanup.",
+			`Rerun ${verificationCommand}.`
+		],
+		installCommands,
 		paths: legacyFindings.map((finding) => finding.skillDir),
-		cleanupCommands: legacyFindings.flatMap((finding) => finding.cleanupCommands)
+		cleanupCommands: legacyFindings.flatMap((finding) => finding.cleanupCommands),
+		verificationCommand
 	};
 }
+function buildLegacyAtsSkillInstallCommands(legacyFindings) {
+	return [...new Set(legacyFindings.map((finding) => finding.currentInstallCommand))].sort((left, right) => left.localeCompare(right));
+}
 function emitLegacyAtsSkillAgentAttention(input) {
 	if (input.legacyFindings.length === 0) return;
 	const review = buildLegacyAtsSkillAgentReview(input.legacyFindings);
 	const directoryLabel = input.legacyFindings.length === 1 ? "directory" : "directories";
+	const installCommands = review.installCommands.map((command) => formatAtsCliCommand(command));
+	const verificationCommand = formatAtsCliCommand(review.verificationCommand);
 	input.presenter.line({
 		code: `${input.source}.legacy_attention_required`,
 		text: [
 			`attention required: found ${input.legacyFindings.length} legacy or unmanaged ATS skill ${directoryLabel}: ${review.paths.join(", ")}.`,
 			"These copies are outside the current ATS-managed skill install and can make agents read old ATS instructions.",
-			"Install the current ATS skill first, then remove or rename each listed directory."
+			"Do not read or follow those skill instructions.",
+			`Next: run ${formatInlineCommandList(installCommands)}.`,
+			"After the current skill is installed, rename or remove each listed directory; ATS will not do this automatically.",
+			`Then rerun \`${verificationCommand}\`.`
 		].join(" "),
 		data: {
 			legacyFindingCount: input.legacyFindings.length,
@@ -53432,6 +53492,9 @@ function emitLegacyAtsSkillAgentAttention(input) {
 		}
 	});
 }
+function formatInlineCommandList(commands) {
+	return commands.map((command) => `\`${command}\``).join(", ");
+}
 function formatSkillsCommand(command) {
 	return pc.bold(pc.cyan(formatAtsCliCommand(command)));
 }
@@ -53952,19 +54015,20 @@ function emitInstallSummary(input) {
 	const installedTargets = summarizeInstalledTargets(input.installResults);
 	const failed = input.installResults.filter((item) => item.status === "failed");
 	const skipped = input.installResults.filter((item) => item.status === "skipped");
+	const legacyFindings = input.resolvedView === "agent" ? formatLegacyAtsSkillFindingsForAgentView(input.legacyFindings ?? []) : input.legacyFindings ?? [];
 	const payload = {
 		storeDir: input.storeDir,
 		summary,
 		installedTargets,
 		results: input.installResults,
-		legacyFindings: input.legacyFindings ?? [],
-		legacyFindingCount: input.legacyFindings?.length ?? 0,
-		legacyReview: (input.legacyFindings?.length ?? 0) > 0 ? buildLegacyAtsSkillAgentReview(input.legacyFindings ?? []) : null,
-		requiresReview: summary.failed > 0 || (input.legacyFindings?.length ?? 0) > 0
+		legacyFindings,
+		legacyFindingCount: legacyFindings.length,
+		legacyReview: legacyFindings.length > 0 ? buildLegacyAtsSkillAgentReview(legacyFindings) : null,
+		requiresReview: summary.failed > 0 || legacyFindings.length > 0
 	};
 	if (input.resolvedView === "agent") {
 		emitLegacyAtsSkillAgentAttention({
-			legacyFindings: input.legacyFindings ?? [],
+			legacyFindings,
 			presenter: input.presenter,
 			source: "skills.install"
 		});
@@ -58823,7 +58887,7 @@ function buildReplyReadinessNextSteps(input) {
 		case "runtime.adapter.unsupported": return [formatAtsCliCommand("ats agents detect"), formatAtsCliCommand("ats agents list")];
 		case "controller.bootstrap.failed": return [...buildLocalAgentLaunchRepairNextSteps({ localAgentId: input.localAgentId }), formatAtsCliCommand("openclaw agents list")];
 		case "controller.gateway.unhealthy": return [...buildLocalAgentLaunchRepairNextSteps({ localAgentId: input.localAgentId }), formatAtsCliCommand("openclaw health --json")];
-		case "route.offline": return [formatAtsCliCommand(`ats service status --profile ${profileId}`), formatAtsCliCommand("ats service start")];
+		case "route.offline": return [formatAtsCliCommand(`ats service status --profile ${profileId}`), formatAtsCliCommand("ats service repair")];
 		case "route.not_registered": return [formatAtsCliCommand(`ats service status --profile ${profileId}`), formatAtsCliCommand("ats doctor --repair")];
 		case "service.gateway_chain_unhealthy": return resolveGatewayChainRepairGuidance({}).nextSteps;
 		case "dispatch.storage_not_ready": return resolveGatewayChainRepairGuidance({ failureKind: "dispatch_storage_not_ready" }).nextSteps;
@@ -63612,7 +63676,7 @@ async function emitProfileCreateResult(input) {
 	}
 	input.presenter.line({
 		code: "profile.created",
-		text: `created profile: ${input.profile.atsProfileId}`,
+		text: `created Agent Profile identity: ${input.profile.atsProfileId}`,
 		data: {
 			atsProfileId: input.profile.atsProfileId,
 			profileName: input.profile.profileName,
@@ -63622,6 +63686,7 @@ async function emitProfileCreateResult(input) {
 			...buildAgentProfileStateData(input.profile),
 			...buildAgentProfileRuntimeData(input.agentRuntimeState),
 			currentProfileChanged: false,
+			...buildAgentCreateWakeReadinessData(input.profile),
 			nextSteps: buildAgentCreateNextSteps(input.profile)
 		}
 	});
@@ -63638,6 +63703,7 @@ async function emitProfileCreateResult(input) {
 			createdProfileId: input.profile.atsProfileId,
 			currentProfileChanged: false,
 			reason: "Agent View profile creation does not change the acting identity. Pass --profile explicitly when this profile should act.",
+			...buildAgentCreateWakeReadinessData(input.profile),
 			nextSteps: buildAgentCreateNextSteps(input.profile)
 		}
 	});
@@ -64566,11 +64632,12 @@ function renderProfileReadyCard(input) {
 		label: "Default for This Account",
 		value: "Yes"
 	});
+	rows.push(...buildProfileCreateWakeReadinessRows(input));
 	rows.push(...buildAgentProfileStateRows(input.profile));
 	rows.push(...buildAgentProfileRuntimeRows(input.agentRuntimeState));
 	renderInfoCard({
 		presenter: input.presenter,
-		title: "Profile Ready",
+		title: input.state === "created" && input.profile.profileKind === "agent" ? "Agent Profile Identity Created" : "Profile Ready",
 		codePrefix: "profile.created.card",
 		rows,
 		sanitize: true
@@ -64623,6 +64690,12 @@ function renderProfileSummaryCard(input) {
 	});
 }
 function buildAgentCreateNextSteps(profile) {
+	if (profile.profileKind === "agent") return [
+		formatAtsCliCommand(`ats agents prepare --profile ${profile.atsProfileId} --view agent`),
+		formatAtsCliCommand(`ats service status --profile ${profile.atsProfileId} --view agent`),
+		formatAtsCliCommand(`ats profiles show ${profile.atsProfileId} --view agent`),
+		formatAtsCliCommand(`ats whoami --profile ${profile.atsProfileId} --view agent`)
+	];
 	return [
 		formatAtsCliCommand("ats profiles list --view agent"),
 		formatAtsCliCommand(`ats profiles set ${profile.atsProfileId} --view agent`),
@@ -64631,6 +64704,24 @@ function buildAgentCreateNextSteps(profile) {
 		formatAtsCliCommand(`ats space join --profile ${profile.atsProfileId} <space-id> --view agent`)
 	];
 }
+function buildAgentCreateWakeReadinessData(profile) {
+	if (profile.profileKind !== "agent") return {};
+	return {
+		identityCreated: true,
+		wakeReadinessVerified: false,
+		wakeReadinessNote: "This command created the Agent Profile identity. It did not verify that this profile can be woken from a Space or reply from this computer."
+	};
+}
+function buildProfileCreateWakeReadinessRows(input) {
+	if (input.state !== "created" || input.profile.profileKind !== "agent") return [];
+	return [{
+		label: "Wake Readiness",
+		value: "Not verified by profile creation"
+	}, {
+		label: "Next",
+		value: `Run ${formatAtsCliCommand(`ats agents prepare --profile ${input.profile.atsProfileId}`)} before expecting this Agent Profile to reply from a Space.`
+	}];
+}
 function buildAgentUpdateNextSteps(profile) {
 	return [
 		formatAtsCliCommand(`ats profiles show ${profile.atsProfileId} --view agent`),
@@ -65170,7 +65261,8 @@ const PROMPT_GUIDE_CATALOG = {
 		guide: {
 			summary: "Use this guide for `ats space` operations, including create, join, watch, send, guide, password, structured actions, and delete.",
 			humanSteps: [
-				"Treat ATS as an external collaboration layer, not a private scratchpad or transcript mirror.",
+				ATS_AGENT_MENTAL_MODEL_LINES[0],
+				ATS_AGENT_MENTAL_MODEL_LINES[2],
 				"Use canonical `<space-id>` targets instead of space names.",
 				"Keep `--profile <profile-id>` explicit in agent or multi-process workflows.",
 				"If a protected Space blocks access, first confirm the active account/profile. Join once with the Space password only when the account has not joined yet.",
@@ -65183,8 +65275,7 @@ const PROMPT_GUIDE_CATALOG = {
 				"ats space send --profile <profile-id> <space-id> \"<message>\" --view agent",
 				"ats space guide <space-id> --profile <profile-id> --view agent",
 				"ats space publication set <space-id> collaboration --profile <owner-profile-id> --password <space-password> --view agent",
-				"ats prompt space --raw",
-				"ats prompt space-action --raw"
+				"ats prompt space --raw"
 			],
 			notes: [
 				"Collaboration mode is the default: agents should publish concise public outcomes through ATS Space Action rather than mirror all private work into the Space.",
@@ -65215,12 +65306,12 @@ const PROMPT_GUIDE_CATALOG = {
 				"<DISPATCH_ACTION_CLI> space action status done \"short completion update\"",
 				"<DISPATCH_ACTION_CLI> space action silent --reason \"No public reply is needed.\"",
 				"<DISPATCH_ACTION_CLI> space action targets",
-				"<DISPATCH_ACTION_CLI> space action help",
-				"ats prompt space-action --raw"
+				"<DISPATCH_ACTION_CLI> space action help"
 			],
 			notes: [
 				"Write actions require an active ATS Space Wake dispatch context.",
 				"`<DISPATCH_ACTION_CLI>` is a placeholder in guides, not a literal command.",
+				"Fallback JSON is last resort: only if every Space Action CLI command fails, run `ats prompt space-action --raw` and use one trailing `ats-space-action` block.",
 				"Wake targets must be ready Agent Profiles in the current Space.",
 				"`working` is not accepted here because status actions are final visible outcomes in the current contract."
 			]
@@ -65813,8 +65904,47 @@ function buildServiceTraceAgentExecutionStatus(input) {
 		runtimeReadiness: normalizePrepareReadiness(input.prepareReadiness)
 	});
 }
-function buildServiceTraceAgentExecutionStatusRows(projection) {
-	return createAgentExecutionStatusDisplayRows(projection);
+function buildServiceTraceLocalExecutionDiagnosticRows(projection) {
+	return createAgentExecutionStatusDisplayRows(projection).map(formatLocalExecutionDiagnosticRow);
+}
+function formatLocalExecutionDiagnosticRow(row) {
+	switch (row.label) {
+		case "Reply status": return {
+			label: "Current Local Execution Projection",
+			value: formatLocalExecutionProjectionValue(row.value)
+		};
+		case "Connection": return {
+			label: "Current Binding Evidence",
+			value: row.value
+		};
+		case "Local readiness": return {
+			label: "Current Prepare Evidence",
+			value: row.value.replace("Local readiness", "Prepare evidence")
+		};
+		case "Reply route": return {
+			label: "Current Daemon Route Evidence",
+			value: row.value
+		};
+		case "Wake": return {
+			label: "Current Wake Diagnostic",
+			value: row.value.replace("Wake is available from this computer.", "Local evidence says Wake can be attempted from this computer.")
+		};
+		default: return row;
+	}
+}
+function formatLocalExecutionProjectionValue(value) {
+	const [status = "", ...detailParts] = value.split(" · ");
+	const diagnosticStatus = formatLocalExecutionDiagnosticStatus(status);
+	const detail = detailParts.join(" · ");
+	return detail ? `Local evidence: ${diagnosticStatus} · ${detail}` : `Local evidence: ${diagnosticStatus}`;
+}
+function formatLocalExecutionDiagnosticStatus(status) {
+	switch (status) {
+		case "Ready": return "reply-capable";
+		case "Not ready": return "not reply-capable";
+		case "Blocked": return "blocked";
+		default: return status.toLowerCase();
+	}
 }
 function normalizeBindingProjection(binding) {
 	if (!binding) return null;
@@ -65981,6 +66111,7 @@ async function runServiceTrace(input, deps = {}) {
 	});
 	const daemonDispatchJournal = resolveDaemonDispatchJournalEvidence(selection.dispatchId);
 	const agentSummary = buildAgentTraceCompactSummary({ trace: traceResponse.trace });
+	const traceReadinessGuidance = shouldExposeCurrentReadinessGuidance(traceResponse.trace) ? targetContext.guidance : null;
 	const payload = {
 		correlation: traceResponse.correlation,
 		query: traceResponse.query,
@@ -66008,7 +66139,7 @@ async function runServiceTrace(input, deps = {}) {
 		},
 		currentProfileWorkspace: targetContext.currentProfileWorkspace,
 		agentSummary,
-		guidance: targetContext.guidance
+		guidance: traceReadinessGuidance
 	};
 	if (runtime.resolvedView === "agent") {
 		presenter.data({
@@ -66046,7 +66177,7 @@ async function runServiceTrace(input, deps = {}) {
 			currentDeviceReplyReadiness: targetContext.currentReplyReadiness?.deviceReplyReadiness ?? null,
 			currentDaemonRouteObservation: targetContext.currentReplyReadiness?.daemonRouteObservation ?? null,
 			currentProfileWorkspace: targetContext.currentProfileWorkspace,
-			guidance: targetContext.guidance,
+			guidance: traceReadinessGuidance,
 			claimExecutionDiagnostics,
 			agentExecutionStatus,
 			daemonDispatchJournal
@@ -66300,6 +66431,31 @@ async function resolveTraceTargetContext(input) {
 		guidance
 	};
 }
+const TRACE_GUIDANCE_SUPPRESSED_RUNTIME_COORDINATOR_STATUSES = new Set([
+	"created",
+	"delivery_pending",
+	"delivery_accepted",
+	"accepted_local",
+	"running",
+	"completed_local",
+	"result_received",
+	"result_accepted",
+	"reply_published"
+]);
+const TRACE_GUIDANCE_SUPPRESSED_HEAD_STATUSES = new Set([
+	"accepted",
+	"execution_linked",
+	"waiting",
+	"publication_intent_ready"
+]);
+function shouldExposeCurrentReadinessGuidance(trace) {
+	if (!trace) return true;
+	if (projectSpaceDispatchTraceFinalVisibleOutcome(trace).delivered) return false;
+	const executionStatus = trace.runtimeCoordinatorExecution?.status ?? null;
+	if (executionStatus && TRACE_GUIDANCE_SUPPRESSED_RUNTIME_COORDINATOR_STATUSES.has(executionStatus)) return false;
+	const headLifecycle = trace.runtimeCoordinatorHeadLifecycle ?? null;
+	return !(headLifecycle?.readStatus === "found" && TRACE_GUIDANCE_SUPPRESSED_HEAD_STATUSES.has(headLifecycle.status));
+}
 function renderLookupNotFound(input) {
 	const lookup = {
 		query: {
@@ -66554,17 +66710,17 @@ function buildHumanTraceRows(input) {
 		{
 			label: "Target",
 			value: input.targetProfile?.profileName ?? input.trace.dispatch.targetProfileId
-		},
-		{
-			label: "Dispatch Ledger Evidence",
-			value: `${input.trace.dispatch.status} · attempts ${input.trace.dispatch.attemptCount}`
-		},
-		{
-			label: "Root Cause",
-			value: resolveTraceRootCause(input.trace)
 		}
 	];
 	appendFinalVisibleOutcomeRows(rows, input.trace);
+	rows.push({
+		label: "Root Cause",
+		value: resolveTraceRootCause(input.trace)
+	});
+	rows.push({
+		label: "Dispatch Ledger Evidence",
+		value: `${input.trace.dispatch.status} · attempts ${input.trace.dispatch.attemptCount}`
+	});
 	appendPublicationDiagnosticRows(rows, input.trace);
 	rows.push({
 		label: "Legacy Claim Diagnostic Evidence",
@@ -66572,10 +66728,10 @@ function buildHumanTraceRows(input) {
 	});
 	if (input.agentExecutionStatus) {
 		rows.push({
-			label: "Current Readiness Evidence",
-			value: "Core AgentExecutionReadiness for this computer; not this Wake's final result."
+			label: "Current Local Execution Diagnostics",
+			value: "Local binding, prepare, daemon route, and claim evidence only; not Core AgentExecutionReadiness and not this Wake's final result."
 		});
-		rows.push(...buildServiceTraceAgentExecutionStatusRows(input.agentExecutionStatus).map(formatServiceTraceAgentExecutionStatusEvidenceRow));
+		rows.push(...buildServiceTraceLocalExecutionDiagnosticRows(input.agentExecutionStatus));
 	}
 	if (input.currentAgentReplyReadiness) {
 		rows.push({
@@ -66584,11 +66740,11 @@ function buildHumanTraceRows(input) {
 		});
 		rows.push({
 			label: "Current Local Reply Evidence",
-			value: formatAgentReplyReadinessLabel(input.currentAgentReplyReadiness)
+			value: formatLocalReplyEvidenceLabel(formatAgentReplyReadinessLabel(input.currentAgentReplyReadiness))
 		});
 		rows.push({
 			label: "Current Local Service Link Evidence",
-			value: input.currentDeviceReplyReadiness === null ? "Unknown" : formatDeviceReplyReadinessLabel(input.currentDeviceReplyReadiness)
+			value: input.currentDeviceReplyReadiness === null ? "Unknown" : formatLocalReplyEvidenceLabel(formatDeviceReplyReadinessLabel(input.currentDeviceReplyReadiness))
 		});
 		if (input.currentDaemonRouteObservation) rows.push({
 			label: "Current Local Reply Route Evidence",
@@ -66639,30 +66795,12 @@ function buildHumanTraceRows(input) {
 	});
 	return rows;
 }
-function formatServiceTraceAgentExecutionStatusEvidenceRow(row) {
-	switch (row.label) {
-		case "Reply status": return {
-			...row,
-			label: "Current Computer Reply Readiness"
-		};
-		case "Connection": return {
-			...row,
-			label: "Current Connection Evidence"
-		};
-		case "Local readiness": return {
-			...row,
-			label: "Current Local Readiness Evidence"
-		};
-		case "Reply route": return {
-			...row,
-			label: "Current Reply Route Evidence"
-		};
-		case "Wake": return {
-			...row,
-			label: "Current Computer Wake Availability"
-		};
-		default: return row;
-	}
+function formatLocalReplyEvidenceLabel(value) {
+	if (value === "Ready") return "Local evidence: reply-capable";
+	if (value.startsWith("Ready · ")) return `Local evidence: reply-capable · ${value.slice(8)}`;
+	if (value === "Not ready") return "Local evidence: not reply-capable";
+	if (value.startsWith("Not ready · ")) return `Local evidence: not reply-capable · ${value.slice(12)}`;
+	return value;
 }
 async function resolveServiceTraceActorProfile(input) {
 	if (normalizeOptionalString$5(input.explicitProfileId) || !canUseInteractivePrompts(input.runtime)) return input.actingProfile;
@@ -67237,6 +67375,8 @@ function appendDispatchExecutionRows(rows, trace) {
 }
 function buildAgentTraceSummary(input) {
 	if (!input.trace) return `dispatch ${input.dispatchId}: not_found`;
+	const finalVisibleOutcome = projectSpaceDispatchTraceFinalVisibleOutcome(input.trace);
+	const finalVisibleOutcomeSummary = finalVisibleOutcome.status === "not_applicable" ? "finalVisibleOutcome=not_applicable" : `finalVisibleOutcome=${finalVisibleOutcome.status}`;
 	const attemptStatus = input.trace.latestAttempt?.status ?? "none";
 	const streamingMode = input.trace.streaming?.streamingMode ?? "final";
 	const previewEmitted = input.trace.streaming?.previewEmitted === true;
@@ -67245,9 +67385,7 @@ function buildAgentTraceSummary(input) {
 	const resultInboxSummary = input.trace.resultInbox ? ` resultInbox=${input.trace.resultInbox.publishState}` : "";
 	const headLifecycleSummary = input.trace.runtimeCoordinatorHeadLifecycle ? ` head=${formatRuntimeCoordinatorHeadLifecycleSummary(input.trace.runtimeCoordinatorHeadLifecycle)}` : "";
 	const finalVisibleSummary = input.trace.finalVisibleMessage ? ` finalVisible=${input.trace.finalVisibleMessage.signalType}:${input.trace.finalVisibleMessage.signalId}` : "";
-	const finalVisibleOutcome = projectSpaceDispatchTraceFinalVisibleOutcome(input.trace);
-	const finalVisibleOutcomeSummary = finalVisibleOutcome.status === "not_applicable" ? "" : ` finalVisibleOutcome=${finalVisibleOutcome.status}`;
-	return `dispatch ${input.trace.dispatch.dispatchId}: status=${input.trace.dispatch.status} rootCause=${resolveTraceRootCause(input.trace)} latestAttempt=${attemptStatus} streaming=${streamingMode} preview=${previewEmitted ? "emitted" : "none"}${headLifecycleSummary}${resultInboxSummary}${finalVisibleSummary}${finalVisibleOutcomeSummary}${runtimeSummary}${dispatchExecutionSummary}`;
+	return `dispatch ${input.trace.dispatch.dispatchId}: ${finalVisibleOutcomeSummary} delivered=${finalVisibleOutcome.delivered ? "true" : "false"} rootCause=${resolveTraceRootCause(input.trace)} status=${input.trace.dispatch.status} latestAttempt=${attemptStatus} streaming=${streamingMode} preview=${previewEmitted ? "emitted" : "none"}${headLifecycleSummary}${resultInboxSummary}${finalVisibleSummary}${runtimeSummary}${dispatchExecutionSummary}`;
 }
 function buildAgentTraceCompactSummary(input) {
 	const trace = input.trace;
@@ -82535,13 +82673,13 @@ function handleBlockedSpaceJoinLocalParticipation(input) {
 	if (input.assessmentState === "not_needed") {
 		input.presenter.line({
 			code: "space.join.service.not_needed",
-			text: formatInlineAtsCliCommands("ATS will keep joining this space without local agent participation on this device. If you later bring local agents from this device into this space, use `ats service install` and `ats service start`.")
+			text: formatInlineAtsCliCommands("ATS will keep joining this space without local Wake participation on this device. Space membership is separate from whether a local agent can reply from this computer. If you later want local agents from this device to reply, run `ats service status` and follow its recovery guidance.")
 		});
 		return "continue";
 	}
 	input.presenter.line({
 		code: "space.join.service.pending",
-		text: formatInlineAtsCliCommands("ATS will keep joining this space without local agent participation on this device until ATS Service is ready. When you want local agents on this device to reply in the background, use `ats service install` and `ats service start`.")
+		text: formatInlineAtsCliCommands("ATS will keep joining this space without local Wake participation on this device. Space membership is separate from whether a local agent can reply from this computer. Run `ats service status` to inspect local participation before expecting background replies.")
 	});
 	return "continue";
 }
@@ -82555,7 +82693,7 @@ function buildSpaceJoinMembershipOnlyMessage(input) {
 	const reasonCodes = input.reasonCodes;
 	const statusCommand = formatAtsCliCommand(`ats service status --profile ${profileId}`);
 	if (reasonCodes.includes("profile.unbound")) return `${profileName} will join this space, but it is not connected to a local agent on this device yet. It can appear here now, but it will not wake or reply from this device until you choose a local agent in ATS Web.`;
-	if (reasonCodes.some((reasonCode) => LOCAL_SERVICE_ONLY_JOIN_BLOCK_REASON_CODES.has(reasonCode)) || reasonCodes.includes("dispatch.storage_not_ready") || reasonCodes.includes("service.gateway_chain_unhealthy") || reasonCodes.includes("route.offline") || reasonCodes.includes("route.not_registered")) return formatInlineAtsCliCommands(`${profileName} will join this space, but it will not wake or reply from this device until ATS Service is ready. Use \`ats service install\`, \`ats service start\`, or \`${statusCommand}\` to check this device.`);
+	if (reasonCodes.some((reasonCode) => LOCAL_SERVICE_ONLY_JOIN_BLOCK_REASON_CODES.has(reasonCode)) || reasonCodes.includes("dispatch.storage_not_ready") || reasonCodes.includes("service.gateway_chain_unhealthy") || reasonCodes.includes("route.offline") || reasonCodes.includes("route.not_registered")) return formatInlineAtsCliCommands(`${profileName} will join this space, but it will not wake or reply from this device yet. Space membership is separate from local Wake participation. Use \`${statusCommand}\` to check this device; if local participation is unhealthy, follow the status or repair guidance before expecting background replies.`);
 	if (reasonCodes.includes("controller.launch.needs_repair") || reasonCodes.includes("controller.launch.choice_required") || reasonCodes.includes("workspace.missing") || reasonCodes.includes("workspace.invalid")) return formatInlineAtsCliCommands(`${profileName} will join this space, but its local agent setup on this device needs attention. Use \`ats agents list\` to find the local agent, then run \`ats agents repair --agent <agent-id>\`.`);
 	return `${profileName} will join this space, but local setup on this device is still incomplete. It can appear here now, but it will not wake or reply from this device until you check Local Agents in ATS Web.`;
 }
@@ -84543,7 +84681,7 @@ function emitSpaceCreatePasswordOptionalHint(input) {
 				minLength: SPACE_PASSWORD_MIN_LENGTH,
 				charset: "any"
 			},
-			command: "ats space create --name <name> --password <value>"
+			command: formatAtsCliCommand("ats space create --name <name> --password <value>")
 		}
 	});
 }
@@ -85245,7 +85383,7 @@ async function ensureSpaceMemberCandidatesLocalParticipationReady(input) {
 		candidates: preparedCandidates.map(toActionParticipationCandidateFromSpaceMemberCandidate)
 	}).shouldOfferServiceGate) input.presenter.line({
 		code: input.resolvedView === "human" && input.allowPrompt ? "space.add_members.service.declined" : "space.add_members.service.deferred",
-		text: formatInlineAtsCliCommands("ATS will continue adding these profiles without local agent participation on this device. If you later want local agents on this device to reply in the background, use `ats service install` and `ats service start`.")
+		text: formatInlineAtsCliCommands("ATS will continue adding these profiles without local Wake participation on this device. Space membership is separate from whether a local agent can reply from this computer. Run `ats service status` to inspect local participation before expecting background replies.")
 	});
 	return {
 		status: "continue",
@@ -85300,11 +85438,11 @@ function buildSpaceMemberJoinOnlyWarning(candidate) {
 }
 function resolveSpaceMemberJoinOnlyNextAction(candidate) {
 	if (candidate.localParticipationReadiness === "not_running") return {
-		command: "ats service start",
+		command: buildSpaceMemberProfileStatusCommand(candidate.profileId),
 		kind: "command"
 	};
 	if (candidate.localParticipationReadiness === "not_installed") return {
-		command: "ats service install",
+		command: buildSpaceMemberProfileStatusCommand(candidate.profileId),
 		kind: "command"
 	};
 	if (candidate.localParticipationReadiness === "needs_repair" || hasSpaceMemberReasonCode(candidate, SPACE_MEMBER_LOCAL_AGENT_REPAIR_REASON_CODES)) return {