@gajae-code/coding-agent 0.15.6 → 0.16.0

package/src/modes/controllers/selector-controller.ts

@@ -4,6 +4,8 @@ import {
 	type Api,
 	type AuthCredentialSelector,
 	type CredentialRemovalTarget,
+	isSqliteCorruptionError,
+	isSqliteError,
 	type Model,
 	resolveOAuthStorageProvider,
 } from "@gajae-code/ai/core";
@@ -106,6 +108,7 @@ import { TelegramDaemonController } from "../../sdk/bus/telegram-daemon-control"
 import { runTelegramSetup, type TelegramSetupPreflight } from "../../sdk/bus/telegram-setup";
 import { clearPersistentPinForRemovedRows } from "../../session/account-inventory";
 import type { DefaultFallbackRuntimeState } from "../../session/agent-session";
+import { CREDENTIAL_STORE_UNREADABLE_MESSAGE } from "../../session/credential-store-errors";
 import { type SessionInfo, SessionManager } from "../../session/session-manager";
 import { getTreeForInternalRead } from "../../session/session-manager-internal";
 import { FileSessionStorage } from "../../session/session-storage";
@@ -125,6 +128,12 @@ import {
 	logCredentialAutoImportFailures,
 	runExternalCredentialAutoImport,
 } from "../../setup/credential-auto-import";
+
+function credentialStoreOperationError(action: "Login" | "Logout", error: unknown): string {
+	const code = error && typeof error === "object" ? (error as { code?: unknown }).code : undefined;
+	return `${action} failed: credential store operation failed${typeof code === "string" ? ` (${code})` : ""}.`;
+}
+
 import {
 	filterAutoImportOAuthCredentials,
 	formatDiscoverySummary,
@@ -172,6 +181,7 @@ import {
 	FrictionlessOnboardingSelectorComponent,
 	type FrictionlessOnboardingStage,
 	getFrictionlessOnboardingCopy,
+	InterfaceLanguageSelectorComponent,
 } from "../components/frictionless-onboarding-selector";
 import type { PetMode } from "../components/gajae-pet-widget";
 import { HistorySearchComponent } from "../components/history-search";
@@ -216,6 +226,7 @@ import type { SessionObserverRegistry } from "../session-observer-registry";
 import { buildOAuthLoginAnchor, createOAuthUrlCopyLease } from "../shared/oauth-url-copy";
 import type { TasksAggregator } from "../tasks-aggregator";
 import type { TranscriptItemRegistry } from "../transcript-item-registry";
+import { resolveExplicitUiLanguage, type UiLanguage } from "../ui-language";
 import { acquireResumeProgressLease, type ResumeProgressLease } from "../utils/ui-helpers";
 
 const CALLBACK_SERVER_PROVIDERS = new Set<string>([
@@ -1366,11 +1377,16 @@ export class SelectorController {
 	async #refreshOAuthProviderAuthState(): Promise<void> {
 		const oauthProviders = getOAuthProviders();
 		await Promise.all(
-			oauthProviders.map(provider =>
-				this.ctx.session.modelRegistry
-					.getApiKeyForProvider(provider.id, this.ctx.session.credentialSessionId)
-					.catch(() => undefined),
-			),
+			oauthProviders.map(async provider => {
+				try {
+					await this.ctx.session.modelRegistry.getApiKeyForProvider(
+						provider.id,
+						this.ctx.session.credentialSessionId,
+					);
+				} catch (error) {
+					if (isSqliteError(error)) throw error;
+				}
+			}),
 		);
 	}
 	/**
@@ -1469,11 +1485,57 @@ export class SelectorController {
 
 	async showFrictionlessOnboarding(): Promise<void> {
 		const agentDir = this.ctx.session.getSessionAgentDir();
+		const languagePreference = resolveExplicitUiLanguage(
+			this.ctx.settings.has("ui.language") ? this.ctx.settings.get("ui.language") : undefined,
+			process.env.GJC_UI_LANGUAGE,
+		);
+		let selectedLanguage: UiLanguage = languagePreference.language;
+		if (!languagePreference.hasPreference && this.ctx.settings.canPersistDurableConfig()) {
+			const decision = Promise.withResolvers<UiLanguage | undefined>();
+			let settled = false;
+			let unregisterStop: (() => void) | undefined;
+			const finish = (language: UiLanguage | undefined): void => {
+				if (settled) return;
+				settled = true;
+				unregisterStop?.();
+				decision.resolve(language);
+			};
+			this.showSelector(done => {
+				unregisterStop = this.ctx.onStop(() => {
+					done();
+					finish(undefined);
+				});
+				const selector = new InterfaceLanguageSelectorComponent(
+					language => {
+						done();
+						finish(language);
+					},
+					() => {
+						done();
+						finish(undefined);
+					},
+				);
+				return { component: selector, focus: selector };
+			});
+			selectedLanguage = (await decision.promise) ?? "en";
+			try {
+				await this.ctx.settings.commitAtomicBatch([{ path: "ui.language", op: "set", value: selectedLanguage }]);
+			} catch (error) {
+				this.ctx.showError(
+					error instanceof Error
+						? `${error.message}; continuing in English.`
+						: "Cannot save the interface language; continuing in English.",
+				);
+				selectedLanguage = "en";
+			}
+		} else if (!languagePreference.hasPreference) {
+			this.ctx.showError("Cannot save the interface language; continuing in English.");
+		}
 		const presence = await discoverOnboardingRootPresence();
 		// An explicit `/language` (or settings) selection outranks locale and transcript evidence.
 		const profileOptions = {
 			osLocale: Intl.DateTimeFormat().resolvedOptions().locale,
-			...(this.ctx.settings.has("ui.language") ? { preferredLanguage: this.ctx.settings.get("ui.language") } : {}),
+			preferredLanguage: selectedLanguage,
 		};
 		const initialProfile = deriveOnboardingProfile([], profileOptions);
 
@@ -3557,7 +3619,8 @@ export class SelectorController {
 			}
 			this.ctx.ui.requestRender();
 		} catch (error: unknown) {
-			this.ctx.showError(`Login failed: ${error instanceof Error ? error.message : String(error)}`);
+			if (isSqliteCorruptionError(error)) this.ctx.showError(CREDENTIAL_STORE_UNREADABLE_MESSAGE);
+			else this.ctx.showError(`Login failed: ${error instanceof Error ? error.message : String(error)}`);
 		} finally {
 			oauthUrlCopyLease.release();
 			if (useManualInput) {
@@ -3599,7 +3662,8 @@ export class SelectorController {
 				`Successfully removed ${result.ids.length} stored credential${result.ids.length === 1 ? "" : "s"} from ${providerId}.`,
 			);
 		} catch (error: unknown) {
-			this.ctx.showError(`Logout failed: ${error instanceof Error ? error.message : String(error)}`);
+			if (isSqliteCorruptionError(error)) this.ctx.showError(CREDENTIAL_STORE_UNREADABLE_MESSAGE);
+			else this.ctx.showError(`Logout failed: ${error instanceof Error ? error.message : String(error)}`);
 		}
 	}
 
@@ -3616,75 +3680,90 @@ export class SelectorController {
 				return;
 			}
 			const authStorage = this.ctx.session.modelRegistry.authStorage;
-			const hasOAuthInventory = authStorage
-				.listCredentialInventory(selectedProviderId)
-				.some(row => row.provider === selectedProviderId && row.credentialKind === "oauth");
-			const hasRemovableCredential = authStorage
-				.listCredentialRemovalTargets(selectedProviderId)
-				.some(target => target.provider === selectedProviderId);
-			if (mode === "logout" && hasOAuthInventory && !hasRemovableCredential) {
-				await this.#handleLogout(selectedProviderId);
-				return;
-			}
-			if (hasOAuthInventory && !options?.manualCode) {
-				this.showSelector(done => {
-					let selector: OAuthSelectorComponent;
-					selector = new OAuthSelectorComponent(
-						mode,
-						authStorage,
-						() => undefined,
-						() => {
-							selector.stopValidation();
-							done();
-							this.ctx.ui.requestRender();
-						},
-						{
-							accountProviderId: selectedProviderId,
-							onAccountSelect: async (selectorValue: AuthCredentialSelector) => {
-								await this.ctx.session.setCredentialPin(selectedProviderId, selectorValue);
-								selector.stopValidation();
-								done();
-								this.ctx.showStatus(`Pinned OAuth account for ${selectedProviderId} to this session.`);
-							},
-							onAutoSelect: async () => {
-								await this.ctx.session.setCredentialAuto(selectedProviderId);
-								selector.stopValidation();
-								done();
-								this.ctx.showStatus(`Using AUTO (ranked) OAuth accounts for ${selectedProviderId}.`);
-							},
-							onAddAccount: async () => {
+			try {
+				const hasOAuthInventory = authStorage
+					.listCredentialInventory(selectedProviderId)
+					.some(row => row.provider === selectedProviderId && row.credentialKind === "oauth");
+				const hasRemovableCredential = authStorage
+					.listCredentialRemovalTargets(selectedProviderId)
+					.some(target => target.provider === selectedProviderId);
+				if (mode === "logout" && hasOAuthInventory && !hasRemovableCredential) {
+					await this.#handleLogout(selectedProviderId);
+					return;
+				}
+				if (hasOAuthInventory && !options?.manualCode) {
+					this.showSelector(done => {
+						let selector: OAuthSelectorComponent;
+						selector = new OAuthSelectorComponent(
+							mode,
+							authStorage,
+							() => undefined,
+							() => {
 								selector.stopValidation();
 								done();
-								await this.#handleOAuthLogin(selectedProviderId, options);
+								this.ctx.ui.requestRender();
 							},
-							onAccountRemove: async targets => {
-								await this.#handleLogout(selectedProviderId, targets);
-								selector.stopValidation();
-								done();
+							{
+								accountProviderId: selectedProviderId,
+								onAccountSelect: async (selectorValue: AuthCredentialSelector) => {
+									await this.ctx.session.setCredentialPin(selectedProviderId, selectorValue);
+									selector.stopValidation();
+									done();
+									this.ctx.showStatus(`Pinned OAuth account for ${selectedProviderId} to this session.`);
+								},
+								onAutoSelect: async () => {
+									await this.ctx.session.setCredentialAuto(selectedProviderId);
+									selector.stopValidation();
+									done();
+									this.ctx.showStatus(`Using AUTO (ranked) OAuth accounts for ${selectedProviderId}.`);
+								},
+								onAddAccount: async () => {
+									selector.stopValidation();
+									done();
+									await this.#handleOAuthLogin(selectedProviderId, options);
+								},
+								onAccountRemove: async targets => {
+									await this.#handleLogout(selectedProviderId, targets);
+									selector.stopValidation();
+									done();
+								},
 							},
-						},
-					);
-					return { component: selector, focus: selector };
-				});
+						);
+						return { component: selector, focus: selector };
+					});
+					return;
+				}
+				if (mode === "login") {
+					await this.#handleOAuthLogin(selectedProviderId, options);
+					return;
+				}
+				// mode === "logout" with no OAuth accounts: remove stored api-key credentials directly.
+				await this.#handleLogout(selectedProviderId);
 				return;
-			}
-			if (mode === "login") {
-				await this.#handleOAuthLogin(selectedProviderId, options);
+			} catch (error: unknown) {
+				if (isSqliteCorruptionError(error)) this.ctx.showError(CREDENTIAL_STORE_UNREADABLE_MESSAGE);
+				else if (isSqliteError(error))
+					this.ctx.showError(credentialStoreOperationError(mode === "login" ? "Login" : "Logout", error));
+				else throw error;
 				return;
 			}
-			// mode === "logout" with no OAuth accounts: remove stored api-key credentials directly.
-			await this.#handleLogout(selectedProviderId);
-			return;
 		}
 
 		if (mode === "logout") {
-			await this.#refreshOAuthProviderAuthState();
-			const oauthProviders = getOAuthProviders();
-			const loggedInProviders = oauthProviders.filter(provider =>
-				this.ctx.session.modelRegistry.authStorage.hasAuth(provider.id),
-			);
-			if (loggedInProviders.length === 0) {
-				this.ctx.showStatus("No OAuth providers logged in. Use /login first.");
+			try {
+				await this.#refreshOAuthProviderAuthState();
+				const oauthProviders = getOAuthProviders();
+				const loggedInProviders = oauthProviders.filter(provider =>
+					this.ctx.session.modelRegistry.authStorage.hasAuth(provider.id),
+				);
+				if (loggedInProviders.length === 0) {
+					this.ctx.showStatus("No OAuth providers logged in. Use /login first.");
+					return;
+				}
+			} catch (error: unknown) {
+				if (isSqliteCorruptionError(error)) this.ctx.showError(CREDENTIAL_STORE_UNREADABLE_MESSAGE);
+				else if (isSqliteError(error)) this.ctx.showError(credentialStoreOperationError("Logout", error));
+				else throw error;
 				return;
 			}
 		}
@@ -3807,37 +3886,53 @@ export class SelectorController {
 				}
 			}
 		}
-		this.showSelector(done => {
-			let selector: OAuthSelectorComponent;
-			selector = new OAuthSelectorComponent(
-				mode,
-				this.ctx.session.modelRegistry.authStorage,
-				async (selectedProviderId: string) => {
-					selector.stopValidation();
-					done();
-					await this.showOAuthSelector(mode, selectedProviderId);
-				},
-				() => {
-					selector.stopValidation();
-					done();
-					this.ctx.ui.requestLayoutRender("oauth-selector-close");
-				},
-				{
-					validateAuth: async (selectedProviderId: string) => {
-						const apiKey = await this.ctx.session.modelRegistry.getApiKeyForProvider(
-							selectedProviderId,
-							this.ctx.session.credentialSessionId,
-						);
-						return !!apiKey;
+		try {
+			this.showSelector(done => {
+				let selector: OAuthSelectorComponent;
+				selector = new OAuthSelectorComponent(
+					mode,
+					this.ctx.session.modelRegistry.authStorage,
+					async (selectedProviderId: string) => {
+						selector.stopValidation();
+						done();
+						await this.showOAuthSelector(mode, selectedProviderId);
 					},
-					requestRender: () => {
-						this.ctx.ui.requestLayoutRender("oauth-selector-spinner");
+					() => {
+						selector.stopValidation();
+						done();
+						this.ctx.ui.requestLayoutRender("oauth-selector-close");
 					},
-					externalCredentialCandidates,
-				},
-			);
-			return { component: selector, focus: selector };
-		});
+					{
+						validateAuth: async (selectedProviderId: string) => {
+							const apiKey = await this.ctx.session.modelRegistry.getApiKeyForProvider(
+								selectedProviderId,
+								this.ctx.session.credentialSessionId,
+							);
+							return !!apiKey;
+						},
+						onValidationError: error => {
+							if (!isSqliteError(error)) return false;
+							selector.stopValidation();
+							done();
+							this.ctx.showError(
+								isSqliteCorruptionError(error)
+									? CREDENTIAL_STORE_UNREADABLE_MESSAGE
+									: credentialStoreOperationError("Login", error),
+							);
+							return true;
+						},
+						requestRender: () => {
+							this.ctx.ui.requestLayoutRender("oauth-selector-spinner");
+						},
+						externalCredentialCandidates,
+					},
+				);
+				return { component: selector, focus: selector };
+			});
+		} catch (error: unknown) {
+			if (!isSqliteCorruptionError(error)) throw error;
+			this.ctx.showError(CREDENTIAL_STORE_UNREADABLE_MESSAGE);
+		}
 	}
 
 	showDebugSelector(): void {

package/src/modes/print-mode.ts

@@ -5,6 +5,7 @@
  * - `gjc -p "prompt"` - text output
  * - `gjc --mode json "prompt"` - JSON event stream
  */
+import type { AgentMessage } from "@gajae-code/agent-core";
 import { type AssistantMessage, type ImageContent, isContextOverflow } from "@gajae-code/ai/core";
 import { isKnownSinkPeerClosedError, logger, sanitizeText } from "@gajae-code/utils";
 import { loadSlashCommands } from "../extensibility/slash-commands";
@@ -46,6 +47,48 @@ export interface PrintModeOptions {
  */
 export const CONTEXT_OVERFLOW_EXIT_CODE = 78;
 
+const EMPTY_TURN_ERROR = {
+	code: "empty_response",
+	message: "Turn completed without assistant text.",
+} as const;
+
+export type PrintTerminalDisposition =
+	| { status: "success"; assistantText: true }
+	| { status: "failure"; error: typeof EMPTY_TURN_ERROR | { code: "assistant_error"; message: string } };
+
+function assistantText(message: AssistantMessage): string {
+	return message.content
+		.filter((content): content is { type: "text"; text: string } => content.type === "text")
+		.map(content => content.text)
+		.join("");
+}
+
+export function resolvePrintTerminalDisposition(
+	messages: readonly AgentMessage[],
+	submittedPrompt: boolean,
+	turnStartIndex?: number,
+): PrintTerminalDisposition | undefined {
+	if (!submittedPrompt) return undefined;
+	const turnMessages = turnStartIndex === undefined ? messages : messages.slice(turnStartIndex);
+	const lastAssistant = turnMessages.findLast((message): message is AssistantMessage => message.role === "assistant");
+	if (!lastAssistant) return { status: "failure", error: EMPTY_TURN_ERROR };
+	if (
+		(lastAssistant.stopReason === "error" || lastAssistant.stopReason === "aborted") &&
+		!isSilentAbort(lastAssistant.errorMessage)
+	) {
+		return {
+			status: "failure",
+			error: {
+				code: "assistant_error",
+				message: sanitizeText(lastAssistant.errorMessage || `Request ${lastAssistant.stopReason}`),
+			},
+		};
+	}
+	if (isSilentAbort(lastAssistant.errorMessage)) return undefined;
+	if (assistantText(lastAssistant).trim().length === 0) return { status: "failure", error: EMPTY_TURN_ERROR };
+	return { status: "success", assistantText: true };
+}
+
 /**
  * Build an actionable stderr diagnostic for a terminal context-overflow error in
  * text mode. The raw provider message is preserved (appended) for debugging, but
@@ -201,6 +244,8 @@ export async function runPrintMode(session: AgentSession, options: PrintModeOpti
 	let unsubscribe: (() => void) | undefined;
 	let submittedPrompt = false;
 	let consumedCommand = false;
+	let jsonFailureObserved = false;
+	let lastPromptMessageStart: number | undefined;
 
 	try {
 		for (const warning of new Set(session.configWarnings)) {
@@ -237,6 +282,14 @@ export async function runPrintMode(session: AgentSession, options: PrintModeOpti
 		// when it must render the JSON event stream.
 		if (mode === "json") {
 			unsubscribe = session.subscribe(event => {
+				if (
+					event.type === "agent_failed" ||
+					(event.type === "message_end" &&
+						event.message.role === "assistant" &&
+						(event.message.stopReason === "error" || event.message.stopReason === "aborted"))
+				) {
+					jsonFailureObserved = true;
+				}
 				stdout.write(`${JSON.stringify(event)}\n`);
 			});
 		}
@@ -265,6 +318,7 @@ export async function runPrintMode(session: AgentSession, options: PrintModeOpti
 				if (command !== false) text = command.prompt;
 			}
 			submittedPrompt = true;
+			lastPromptMessageStart = session.state.messages.length;
 			await session.prompt(text, images ? { images } : undefined);
 		};
 
@@ -277,6 +331,16 @@ export async function runPrintMode(session: AgentSession, options: PrintModeOpti
 			await logger.time("print:prompt:next", () => submitInput(message));
 		}
 
+		const terminal = resolvePrintTerminalDisposition(session.state.messages, submittedPrompt, lastPromptMessageStart);
+		if (terminal?.status === "failure") {
+			if (!options.suppressProcessExit) process.exitCode = 1;
+			if (mode === "json" && !jsonFailureObserved) {
+				stdout.write(`${JSON.stringify({ type: "agent_failed", error: terminal.error })}\n`);
+			} else if (mode === "text" && terminal.error.code === EMPTY_TURN_ERROR.code) {
+				await writeStderrAndQuiesce(`${terminal.error.message}\n`);
+			}
+		}
+
 		// In text mode, output final response.
 		if (mode === "text" && (!consumedCommand || submittedPrompt)) {
 			const lastMessage = session.state.messages.findLast(message => message.role === "assistant");

package/src/modes/ui-language.ts

@@ -1,4 +1,4 @@
-export const UI_LANGUAGES = ["en", "ko", "ja"] as const;
+export const UI_LANGUAGES = ["en", "ko", "zh", "ja"] as const;
 
 export type UiLanguage = (typeof UI_LANGUAGES)[number];
 
@@ -23,6 +23,7 @@ const ENGLISH_STRINGS = {
 	"settings.language.description": "Language for human-facing interactive UI text",
 	"settings.language.english": "English",
 	"settings.language.korean": "Korean (한국어)",
+	"settings.language.chinese": "Chinese (简体中文)",
 	"settings.language.japanese": "Japanese (日本語)",
 	"language.current": "Current UI language:",
 	"language.changed": "UI language changed to",
@@ -52,6 +53,7 @@ const KOREAN_STRINGS: Record<UiStringKey, string> = {
 	"settings.language.description": "사람이 읽는 대화형 UI 텍스트의 언어",
 	"settings.language.english": "English",
 	"settings.language.korean": "한국어",
+	"settings.language.chinese": "简体中文",
 	"settings.language.japanese": "日本語",
 	"language.current": "현재 UI 언어:",
 	"language.changed": "UI 언어를 다음으로 변경했습니다:",
@@ -79,21 +81,61 @@ const JAPANESE_STRINGS: Record<UiStringKey, string> = {
 	"settings.language.description": "対話型 UI テキストに使う言語",
 	"settings.language.english": "English",
 	"settings.language.korean": "한국어",
+	"settings.language.chinese": "简体中文",
 	"settings.language.japanese": "日本語",
 	"language.current": "現在の UI 言語:",
 	"language.changed": "UI 言語を次に変更しました:",
 	"language.unknown": "不明な言語",
 };
 
+const CHINESE_STRINGS: Record<UiStringKey, string> = {
+	"settings.title": "设置",
+	"settings.navigationHint": "（按 Tab 切换）",
+	"settings.selectHint": "  Enter：选择 · Esc：返回",
+	"settings.preview": "预览：",
+	"settings.tab.appearance": "外观",
+	"settings.tab.model": "模型",
+	"settings.tab.interaction": "交互",
+	"settings.tab.context": "上下文",
+	"settings.tab.memory": "记忆",
+	"settings.tab.editing": "编辑",
+	"settings.tab.tools": "工具",
+	"settings.tab.tasks": "任务",
+	"settings.tab.providers": "提供商",
+	"settings.tab.notifications": "通知",
+	"settings.tab.plugins": "插件",
+	"settings.tab.gjcBundles": "GJC 捆绑包",
+	"settings.language.label": "语言",
+	"settings.language.description": "面向用户的交互式界面文字所使用的语言",
+	"settings.language.english": "English",
+	"settings.language.korean": "한국어",
+	"settings.language.chinese": "简体中文",
+	"settings.language.japanese": "日本語",
+	"language.current": "当前界面语言：",
+	"language.changed": "界面语言已更改为",
+	"language.unknown": "未知语言",
+};
+
 const STRINGS: Record<UiLanguage, Record<UiStringKey, string>> = {
 	en: ENGLISH_STRINGS,
 	ko: KOREAN_STRINGS,
+	zh: CHINESE_STRINGS,
 	ja: JAPANESE_STRINGS,
 };
 
 /** User selection is authoritative; invalid or unavailable values deterministically fall back to English. */
 export function resolveUiLanguage(value: unknown): UiLanguage {
-	return value === "ko" || value === "ja" ? value : "en";
+	return value === "ko" || value === "zh" || value === "ja" ? value : "en";
+}
+
+/** Resolve explicit startup preference without allowing an invalid value to block startup. */
+export function resolveExplicitUiLanguage(
+	configuredValue: unknown,
+	environmentValue: string | undefined,
+): { language: UiLanguage; hasPreference: boolean } {
+	if (configuredValue !== undefined) return { language: resolveUiLanguage(configuredValue), hasPreference: true };
+	if (environmentValue === undefined) return { language: "en", hasPreference: false };
+	return { language: parseUiLanguage(environmentValue) ?? "en", hasPreference: true };
 }
 
 export function uiString(language: unknown, key: UiStringKey): string {
@@ -104,6 +146,7 @@ export function uiString(language: unknown, key: UiStringKey): string {
 export const UI_LANGUAGE_LABELS: Record<UiLanguage, string> = {
 	en: "English",
 	ko: "한국어",
+	zh: "简体中文",
 	ja: "日本語",
 };
 
@@ -117,6 +160,10 @@ const UI_LANGUAGE_ALIASES: Readonly<Record<string, UiLanguage>> = {
 	kor: "ko",
 	korean: "ko",
 	한국어: "ko",
+	zh: "zh",
+	中文: "zh",
+	简体中文: "zh",
+	chinese: "zh",
 	ja: "ja",
 	jp: "ja",
 	jpn: "ja",

package/src/prompts/system/master-mode.md

@@ -0,0 +1,28 @@
+# Master Mode
+
+You are running as a GJC master session. You coordinate peer GJC sessions through the local Broker; you never control them directly.
+
+## Discovery and scope
+
+- Your launch scope (`repo`, `pwd`, or `global`) bounds which peers you see. Every search result states its requested and resolved scope; trust that envelope, never assume wider visibility.
+- Use `gjc sdk search [--scope repo|pwd|global] [--json]` for explicit scope-filtered discovery. Rows carry index live evidence plus a bounded probe verdict (`reachable`, `unreachable`, `stale`).
+- A `not-in-git-worktree` result is a successful empty answer for `repo` scope outside a Git worktree; it never falls back to another scope.
+- The one-time `<gjc-master-peer-snapshot>` block in your first request is a startup observation, not a live view; re-run `gjc sdk search` before acting on peers.
+
+## Peer orchestration
+
+- All peer control is broker-routed and best effort: inspect, status, send, tail, steer, and interrupt through the `gjc sdk session` commands. Pre-existing peers owe you nothing; treat them as independent owners.
+- Read-only first: inspect and observe a peer before sending steering or interrupts.
+- Never steer a peer while its user is mid-turn; wait for the peer to be idle or explicitly awaiting input.
+- Do not invent locks, reservations, or exclusive claims over peers; no such mechanism exists, and pretending otherwise corrupts coordination.
+
+## Spawning children
+
+- `gjc sdk spawn --cwd <dir> --prompt <task> [--model <selector>] [--profile <name>] [--idempotency-key <key>]` creates one task-seeded background child through the Broker. It is legal only inside this interactive master session.
+- One idempotency identity produces at most one child and one seed prompt. Reuse of the same key replays the stored outcome; a semantically new task requires a new invocation.
+- Spawn responses carry only safe facts (claim, child session id, substrate kind, seed phase/status). `spawn_in_progress` and `terminal_uncertain` are honest states: never retry them blindly; inspect with `gjc sdk search` / session status instead. For `uncertain_after_send`, repeat the same spawn invocation with its reported `--idempotency-key` to join the original claim rather than create another child.
+
+## Delegation discipline
+
+- Give each spawned child one bounded task with explicit acceptance criteria in the seed prompt; monitor via broker-routed status/tail and aggregate results yourself.
+- Clean up children you created with `gjc sdk session raw global --op session.close --json-input '{"sessionId":"<id>"}' --idempotency-key <key>` when their work is integrated. Orphaned children are reaped automatically after the configured grace period, but explicit close is the polite default.