@gajae-code/coding-agent 0.2.3 → 0.2.4

package/dist/types/cli/update-cli.d.ts

@@ -21,6 +21,9 @@ export declare function parseUpdateArgs(args: string[]): {
     check: boolean;
 } | undefined;
 export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: string | undefined): "bun" | "binary";
+export declare function formatBinaryDownloadFailureMessageForTest(binaryName: string, url: string, status: string | number, platform?: NodeJS.Platform): string;
+export declare function buildReleaseBinaryUrlForTest(version: string, platform?: NodeJS.Platform, arch?: string): string;
+export declare function formatManualUpdateInstructionsForTest(platform?: NodeJS.Platform): string;
 /**
  * Atomically replace the installed binary and roll back if version verification fails.
  */

package/dist/types/config/settings-schema.d.ts

@@ -982,6 +982,24 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Maximum wait between retries, in ms. When the provider asks us to wait longer than this and no credential or model fallback succeeds, the request fails fast instead of sleeping (e.g. 3-hour Anthropic rate-limit windows).";
         };
     };
+    readonly "retry.requestMaxRetries": {
+        readonly type: "number";
+        readonly default: 5;
+        readonly ui: {
+            readonly tab: "model";
+            readonly label: "Provider Request Retries";
+            readonly description: "Maximum provider request retries before a stream is established. Counts retries, not the first attempt. Set to 0 to disable provider request retries.";
+        };
+    };
+    readonly "retry.streamMaxRetries": {
+        readonly type: "number";
+        readonly default: 5;
+        readonly ui: {
+            readonly tab: "model";
+            readonly label: "Provider Stream Retries";
+            readonly description: "Maximum provider stream replay retries for replay-safe transient stream failures. Counts retries, not the first attempt. Set to 0 to disable provider stream retries.";
+        };
+    };
     readonly "retry.fallbackChains": {
         readonly type: "record";
         readonly default: Record<string, string[]>;
@@ -3240,6 +3258,8 @@ export interface RetrySettings {
     maxRetries: number;
     baseDelayMs: number;
     maxDelayMs: number;
+    requestMaxRetries: number;
+    streamMaxRetries: number;
 }
 export interface MemoriesSettings {
     enabled: boolean;

package/dist/types/defaults/gjc-defaults.d.ts

@@ -1,6 +1,6 @@
 export declare const DEFAULT_GJC_DEFINITION_NAMES: readonly ["deep-interview", "ralplan", "team", "ultragoal"];
 export type DefaultGjcDefinitionName = (typeof DEFAULT_GJC_DEFINITION_NAMES)[number];
-export type DefaultGjcDefinitionKind = "skill";
+export type DefaultGjcDefinitionKind = "skill" | "skill-fragment";
 export type EmbeddedDefaultGjcSkill = {
     name: DefaultGjcDefinitionName;
     description: string;
@@ -11,23 +11,35 @@ export type EmbeddedDefaultGjcSkill = {
     content: string;
 };
 export type DefaultGjcInstallStatus = "different" | "matching" | "missing" | "skipped" | "written";
-export interface DefaultGjcDefinition {
-    kind: DefaultGjcDefinitionKind;
+export interface DefaultGjcSkillDefinition {
+    kind: "skill";
     name: DefaultGjcDefinitionName;
     relativePath: string;
     content: string;
 }
+export interface DefaultGjcSkillFragmentDefinition {
+    kind: "skill-fragment";
+    parentSkillName: DefaultGjcDefinitionName;
+    relativePath: string;
+    content: string;
+}
+export type DefaultGjcDefinition = DefaultGjcSkillDefinition | DefaultGjcSkillFragmentDefinition;
 export interface InstallDefaultGjcDefinitionsOptions {
     check?: boolean;
     force?: boolean;
     targetRoot?: string;
 }
-export interface DefaultGjcDefinitionInstallFile {
-    kind: DefaultGjcDefinitionKind;
+export type DefaultGjcDefinitionInstallFile = {
+    kind: "skill";
     name: DefaultGjcDefinitionName;
     path: string;
     status: DefaultGjcInstallStatus;
-}
+} | {
+    kind: "skill-fragment";
+    parentSkillName: DefaultGjcDefinitionName;
+    path: string;
+    status: DefaultGjcInstallStatus;
+};
 export interface DefaultGjcDefinitionInstallResult {
     targetRoot: string;
     total: number;
@@ -40,5 +52,6 @@ export interface DefaultGjcDefinitionInstallResult {
 }
 export declare function getDefaultGjcDefinitions(): readonly DefaultGjcDefinition[];
 export declare function getDefaultGjcAgentDefinitions(): readonly DefaultGjcDefinition[];
+export declare function getEmbeddedDefaultGjcSkillFragments(parentSkillName: DefaultGjcDefinitionName): DefaultGjcSkillFragmentDefinition[];
 export declare function getEmbeddedDefaultGjcSkills(): EmbeddedDefaultGjcSkill[];
 export declare function installDefaultGjcDefinitions(options?: InstallDefaultGjcDefinitionsOptions): Promise<DefaultGjcDefinitionInstallResult>;

package/dist/types/modes/components/settings-selector.d.ts

@@ -29,6 +29,10 @@ export interface StatusLinePreviewSettings {
 export interface SettingsCallbacks {
     /** Called when any setting value changes */
     onChange: (path: SettingPath, newValue: unknown) => void;
+    /** Called for theme preview while browsing theme settings */
+    onThemePreview?: (theme: string) => void | Promise<void>;
+    /** Called to restore the rendered theme when theme settings preview is cancelled */
+    onThemePreviewCancel?: (theme: string) => void | Promise<void>;
     /** Called for status line preview while configuring */
     onStatusLinePreview?: (settings: StatusLinePreviewSettings) => void;
     /** Get current rendered status line for inline preview */

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -15,6 +15,7 @@ export declare class SelectorController {
     }): void;
     showProviderOnboarding(): void;
     showSettingsSelector(): void;
+    showThemeSelector(): void;
     showHistorySearch(): void;
     /**
      * Show the Extension Control Center dashboard.

package/dist/types/modes/interactive-mode.d.ts

@@ -200,6 +200,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     showSettingsSelector(): void;
+    showThemeSelector(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
     showAgentsDashboard(): void;

package/dist/types/modes/theme/defaults/index.d.ts

@@ -467,6 +467,132 @@ export declare const defaultThemes: {
             "infoBg": string;
         };
     };
+    "blue-crab": {
+        $schema: string;
+        name: string;
+        vars: {
+            "cyan": string;
+            "blue": string;
+            "green": string;
+            "red": string;
+            "yellow": string;
+            "gray": string;
+            "dimGray": string;
+            "darkGray": string;
+            "accent": string;
+            "selectedBg": string;
+            "userMsgBg": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "customMsgBg": string;
+            "abyss": string;
+            "deepNavy": string;
+            "crabShell": string;
+            "claw": string;
+            "ocean": string;
+            "azure": string;
+            "seafoam": string;
+            "kelp": string;
+            "sand": string;
+            "coral": string;
+            "ink": string;
+            "mantle": string;
+            "surface": string;
+            "surfaceBright": string;
+            "foam": string;
+            "mutedShell": string;
+            "dimShell": string;
+            "brandBlue": string;
+            "shell": string;
+            "dangerRed": string;
+            "warningAmber": string;
+            "diffRemovalRed": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "link": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+            "pythonMode": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+            "overrides": {
+                "icon.pi": string;
+                "icon.agents": string;
+                "status.running": string;
+                "md.bullet": string;
+            };
+        };
+    };
     "dark-abyss": {
         $schema: string;
         name: string;

package/dist/types/modes/theme/theme.d.ts

@@ -186,6 +186,7 @@ export interface ThemeInfo {
 }
 export declare function getAvailableThemesWithPaths(): Promise<ThemeInfo[]>;
 export declare function getThemeByName(name: string): Promise<Theme | undefined>;
+export declare function getDetectedThemeSettingsPath(): "theme.dark" | "theme.light";
 export declare var theme: Theme;
 /** Get the name of the currently active theme. */
 export declare function getCurrentThemeName(): string | undefined;
@@ -198,6 +199,10 @@ export declare function previewTheme(name: string): Promise<{
     success: boolean;
     error?: string;
 }>;
+export declare function restoreThemePreview(name: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
 /**
  * Enable auto-detection mode, switching to the appropriate dark/light theme.
  */

package/dist/types/modes/types.d.ts

@@ -208,6 +208,7 @@ export interface InteractiveModeContext {
     openInBrowser(urlOrPath: string): void;
     refreshSlashCommandState(cwd?: string): Promise<void>;
     showSettingsSelector(): void;
+    showThemeSelector(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
     showAgentsDashboard(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.2.3",
+	"version": "0.2.4",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -48,12 +48,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.2.3",
-		"@gajae-code/agent-core": "0.2.3",
-		"@gajae-code/ai": "0.2.3",
-		"@gajae-code/natives": "0.2.3",
-		"@gajae-code/tui": "0.2.3",
-		"@gajae-code/utils": "0.2.3",
+		"@gajae-code/stats": "0.2.4",
+		"@gajae-code/agent-core": "0.2.4",
+		"@gajae-code/ai": "0.2.4",
+		"@gajae-code/natives": "0.2.4",
+		"@gajae-code/tui": "0.2.4",
+		"@gajae-code/utils": "0.2.4",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/update-cli.ts

@@ -12,7 +12,7 @@ import { $ } from "bun";
 import chalk from "chalk";
 import { theme } from "../modes/theme/theme";
 
-const REPO = "can1357/gajae-code";
+const RELEASE_REPO = "Yeachan-Heo/gajae-code";
 const PACKAGE = "@gajae-code/coding-agent";
 
 interface ReleaseInfo {
@@ -122,7 +122,7 @@ async function resolveUpdateTarget(): Promise<UpdateTarget> {
 
 	if (bunBinDir) return { method: "bun" };
 
-	throw new Error(`Could not resolve ${APP_NAME} binary path in PATH`);
+	throw new Error(formatUnsupportedTargetMessage(`Could not resolve ${APP_NAME} binary path in PATH`));
 }
 
 /**
@@ -166,10 +166,7 @@ function compareVersions(a: string, b: string): number {
 /**
  * Get the appropriate binary name for this platform.
  */
-function getBinaryName(): string {
-	const platform = process.platform;
-	const arch = process.arch;
-
+function getBinaryName(platform: NodeJS.Platform = process.platform, arch: string = process.arch): string {
 	let os: string;
 	switch (platform) {
 		case "linux":
@@ -182,7 +179,7 @@ function getBinaryName(): string {
 			os = "windows";
 			break;
 		default:
-			throw new Error(`Unsupported platform: ${platform}`);
+			throw new Error(formatUnsupportedTargetMessage(`Unsupported platform: ${platform}`));
 	}
 
 	let archName: string;
@@ -194,7 +191,7 @@ function getBinaryName(): string {
 			archName = "arm64";
 			break;
 		default:
-			throw new Error(`Unsupported architecture: ${arch}`);
+			throw new Error(formatUnsupportedTargetMessage(`Unsupported architecture: ${arch}`));
 	}
 
 	if (os === "windows") {
@@ -233,6 +230,65 @@ function printVerifiedVersion(expectedVersion: string): void {
 	console.log(chalk.green(`\n${theme.status.success} Updated to ${expectedVersion}`));
 }
 
+function formatBinaryInstallInstruction(platform: NodeJS.Platform = process.platform): string {
+	if (platform === "win32") {
+		return `For a supported binary install, reinstall with PowerShell: irm https://raw.githubusercontent.com/${RELEASE_REPO}/main/scripts/install.ps1 | iex`;
+	}
+	return `For a supported binary install, reinstall with: curl -fsSL https://raw.githubusercontent.com/${RELEASE_REPO}/main/scripts/install.sh | sh -s -- --binary`;
+}
+
+function formatManualUpdateInstructions(platform: NodeJS.Platform = process.platform): string {
+	return [
+		`If ${APP_NAME} was installed with Bun, run: bun install -g ${PACKAGE}@latest`,
+		`If ${APP_NAME} was installed with npm, pnpm, or another package manager, update it with that same manager.`,
+		formatBinaryInstallInstruction(platform),
+	].join("\n");
+}
+
+function formatUnsupportedTargetMessage(reason: string, platform: NodeJS.Platform = process.platform): string {
+	return `${reason}.\n${formatManualUpdateInstructions(platform)}`;
+}
+
+function buildReleaseBinaryUrl(
+	version: string,
+	platform: NodeJS.Platform = process.platform,
+	arch: string = process.arch,
+): string {
+	const binaryName = getBinaryName(platform, arch);
+	const tag = `v${version}`;
+	return `https://github.com/${RELEASE_REPO}/releases/download/${tag}/${binaryName}`;
+}
+
+function formatBinaryDownloadFailureMessage(
+	binaryName: string,
+	url: string,
+	status: string | number,
+	platform: NodeJS.Platform = process.platform,
+): string {
+	return `Download failed for ${binaryName} from ${url}: ${status}.\n${formatManualUpdateInstructions(platform)}`;
+}
+
+export function formatBinaryDownloadFailureMessageForTest(
+	binaryName: string,
+	url: string,
+	status: string | number,
+	platform: NodeJS.Platform = process.platform,
+): string {
+	return formatBinaryDownloadFailureMessage(binaryName, url, status, platform);
+}
+
+export function buildReleaseBinaryUrlForTest(
+	version: string,
+	platform: NodeJS.Platform = process.platform,
+	arch: string = process.arch,
+): string {
+	return buildReleaseBinaryUrl(version, platform, arch);
+}
+
+export function formatManualUpdateInstructionsForTest(platform: NodeJS.Platform = process.platform): string {
+	return formatManualUpdateInstructions(platform);
+}
+
 function formatVerificationFailure(result: InstalledVersionVerification, expectedVersion: string): string {
 	if (result.actual) {
 		return `${APP_NAME} at ${result.path} still reports ${result.actual} (expected ${expectedVersion})`;
@@ -250,11 +306,7 @@ async function printVerification(expectedVersion: string): Promise<void> {
 		return;
 	}
 	console.log(chalk.yellow(`\nWarning: ${formatVerificationFailure(result, expectedVersion)}`));
-	console.log(
-		chalk.yellow(
-			`You may need to reinstall: curl -fsSL https://raw.githubusercontent.com/can1357/gajae-code/main/scripts/install.sh | sh`,
-		),
-	);
+	console.log(chalk.yellow(formatManualUpdateInstructions()));
 }
 
 async function unlinkIfExists(filePath: string): Promise<void> {
@@ -314,8 +366,7 @@ async function updateViaBun(expectedVersion: string): Promise<void> {
  */
 async function updateViaBinaryAt(targetPath: string, expectedVersion: string): Promise<void> {
 	const binaryName = getBinaryName();
-	const tag = `v${expectedVersion}`;
-	const url = `https://github.com/${REPO}/releases/download/${tag}/${binaryName}`;
+	const url = buildReleaseBinaryUrl(expectedVersion);
 
 	const tempPath = `${targetPath}.new`;
 	const backupPath = `${targetPath}.bak`;
@@ -323,7 +374,7 @@ async function updateViaBinaryAt(targetPath: string, expectedVersion: string): P
 
 	const response = await fetch(url, { redirect: "follow" });
 	if (!response.ok || !response.body) {
-		throw new Error(`Download failed: ${response.statusText}`);
+		throw new Error(formatBinaryDownloadFailureMessage(binaryName, url, response.statusText || response.status));
 	}
 	const fileStream = fs.createWriteStream(tempPath, { mode: 0o755 });
 	await pipeline(response.body, fileStream);

package/src/config/settings-schema.ts

@@ -843,6 +843,26 @@ export const SETTINGS_SCHEMA = {
 				"Maximum wait between retries, in ms. When the provider asks us to wait longer than this and no credential or model fallback succeeds, the request fails fast instead of sleeping (e.g. 3-hour Anthropic rate-limit windows).",
 		},
 	},
+	"retry.requestMaxRetries": {
+		type: "number",
+		default: 5,
+		ui: {
+			tab: "model",
+			label: "Provider Request Retries",
+			description:
+				"Maximum provider request retries before a stream is established. Counts retries, not the first attempt. Set to 0 to disable provider request retries.",
+		},
+	},
+	"retry.streamMaxRetries": {
+		type: "number",
+		default: 5,
+		ui: {
+			tab: "model",
+			label: "Provider Stream Retries",
+			description:
+				"Maximum provider stream replay retries for replay-safe transient stream failures. Counts retries, not the first attempt. Set to 0 to disable provider stream retries.",
+		},
+	},
 	"retry.fallbackChains": { type: "record", default: {} as Record<string, string[]> },
 	"retry.fallbackRevertPolicy": {
 		type: "enum",
@@ -2833,6 +2853,8 @@ export interface RetrySettings {
 	maxRetries: number;
 	baseDelayMs: number;
 	maxDelayMs: number;
+	requestMaxRetries: number;
+	streamMaxRetries: number;
 }
 
 export interface MemoriesSettings {

package/src/defaults/gjc/skills/deep-interview/SKILL.md

@@ -39,6 +39,7 @@ Inspired by the [Ouroboros project](https://github.com/Q00/ouroboros) which demo
 
 <Execution_Policy>
 - Ask ONE question at a time -- never batch multiple questions
+- Preserve the user/session language for every user-facing announcement, topology confirmation, option label, and interview question when state includes `language.instruction`; for example Korean initial ideas must receive Korean deep-interview questions unless the user explicitly requests another language
 - Target the WEAKEST clarity dimension with each question
 - Before Round 1 ambiguity scoring, run a one-time Round 0 topology enumeration gate that confirms the top-level component list and locks it into state
 - Make weakest-dimension targeting explicit every round: name the weakest dimension, state its score/gap, and explain why the next question is aimed there
@@ -54,6 +55,15 @@ Inspired by the [Ouroboros project](https://github.com/Q00/ouroboros) which demo
 - Challenge agents activate at specific round thresholds to shift perspective
 </Execution_Policy>
 
+<Internal_Auto_Mode_Protocol>
+- `auto-research-greenfield.md` and `auto-answer-uncertain.md` are internal prompt fragments loaded on demand with bundle metadata `kind: "skill-fragment"`; they are not public skills, are never slash-command/discoverable, and must not be registered through any `skill://` route.
+- Load fragments only for the specific hook that needs them, with forked inherited context kept read-only and prompt-budgeted; summarize active interview context before spawning the architect if the payload is large.
+- Auto-mode architects are read-only: no code edits, no `.gjc/` mutation, no workflow chaining, no formatters, and no execution delegation.
+- Validate every fragment response before using it: required sections must be present, candidates/answer must match the requested shape, rationale must cite available context, confidence must be explicit, and insufficient-context fallbacks must be honored.
+- If architect spawn, fragment loading, or response validation fails, continue the normal manual interview path silently and record an internal audit note in state by incrementing `architect_failures`; do not expose tool noise to the user unless it changes the next user-facing question.
+- Track `auto_researched_rounds`, `auto_answered_rounds`, and `architect_failures` in state and final spec metadata.
+</Internal_Auto_Mode_Protocol>
+
 
 
 <Steps>
@@ -83,6 +93,7 @@ Deep Interview threshold: <resolvedThresholdPercent> (source: <resolvedThreshold
    - Substitute `<resolvedThreshold>`, `<resolvedThresholdPercent>`, and `<resolvedThresholdSource>` throughout the remaining instructions before continuing.
    - Include `threshold_source` in the first `gjc state write` payload and preserve it on later state updates; do not edit `.gjc/state` files directly unless an explicit force override is active.
    - Include both threshold and source in the final spec metadata.
+- Read any `language` object from active deep-interview state and carry `language.instruction` forward mechanically. If absent, infer the user/session language from `{{ARGUMENTS}}` only when it is obvious. Do not surprise a Korean session with English questions.
 
 ## Phase 1: Initialize
 
@@ -133,7 +144,10 @@ Deep Interview threshold: <resolvedThresholdPercent> (source: <resolvedThreshold
       "last_targeted_component_id": null
     },
     "challenge_modes_used": [],
-    "ontology_snapshots": []
+    "ontology_snapshots": [],
+    "auto_researched_rounds": [],
+    "auto_answered_rounds": [],
+    "architect_failures": 0
   }
 }
 ```
@@ -170,7 +184,7 @@ I'm reading this as {N} top-level component(s):
 Is that topology right? Should any component be added, removed, merged, split, or explicitly deferred?
 ```
 
-Options should include contextually relevant choices such as **Looks right**, **Add/remove/merge components**, **Defer one or more components**, plus free-text. This is the only pre-scoring question and preserves the one-question-per-round rule.
+Options should include contextually relevant choices such as **Looks right**, **Add/remove/merge components**, **Defer one or more components**, plus free-text, translated/localized according to `language.instruction` when present. This is the only pre-scoring question and preserves the one-question-per-round rule.
 
 3. **Lock topology into state** after the answer. Store a normalized component list and confirmation timestamp:
 
@@ -246,9 +260,15 @@ If any prompt input is too large, summarize it first and then continue from the
 | Context Clarity (brownfield) | "How does this fit?" | "I found JWT auth middleware in `src/auth/` (pattern: passport + JWT). Should this feature extend that path or intentionally diverge from it?" |
 | Scope-fuzzy / ontology stress | "What IS the core thing here?" | "You have named Tasks, Projects, and Workspaces across the last rounds. Which one is the core entity, and which are supporting views or containers?" |
 
+### Step 2a′: Auto-Research Greenfield Questions
+
+When the next question is for a greenfield interview and is tagged `research: true`, load `auto-research-greenfield.md` as an internal `kind: "skill-fragment"` prompt for a fork-context architect before Step 2b. Pass only the tagged question, locked topology summary, prompt-safe initial idea, trimmed prior decisions/gaps, and relevant constraints. The architect must return 2-3 ranked candidates with rationale, confidence, and fallback notes. Validate the shape before use; if valid, incorporate the candidates as concise answer options or context for the single user-facing question and append the round number to `auto_researched_rounds`. If invalid or unavailable, fall back silently to the normal generated question and increment `architect_failures`.
+
+Auto-research must never add a public skill entrypoint, never be slash-command/discoverable, never register a `skill://` handler, and never alter the one-question-per-round rule.
+
 ### Step 2b: Ask the Question
 
-Use the `ask` tool with the generated question. Present it clearly with the current ambiguity context:
+Use the `ask` tool with the generated question. Before rendering the prompt/options, apply `language.instruction` from state when present so the entire user-facing question remains in the preserved session language. Present it clearly with the current ambiguity context:
 
 ```
 Round {n} | Component: {target_component_name} | Targeting: {weakest_dimension} | Why now: {one_sentence_targeting_rationale} | Ambiguity: {score}%
@@ -258,10 +278,18 @@ Round {n} | Component: {target_component_name} | Targeting: {weakest_dimension}
 
 Options should include contextually relevant choices plus free-text.
 
+### Step 2b′: Auto-Answer Opted-Out Questions
+
+After the `ask` tool resolves and before ambiguity scoring, if the user opts out of answering the current question or explicitly asks the agent to decide, load `auto-answer-uncertain.md` as an internal `kind: "skill-fragment"` prompt for a fork-context architect. Pass the opted-out question, prompt-safe transcript summary, locked topology, current scores/gaps, and any auto-research candidates used for the round. The architect must return exactly one decisive answer with rationale, confidence, and explicit uncertainty. Validate the response shape before using it; if valid, record it as the tentative answer for scoring, append the round number to `auto_answered_rounds`, and mark the transcript answer as architect-assisted.
+
+Auto-answer has a clarity cap: unless the architect confidence is `high` and uncertainty is negligible, no dimension score improved solely by the auto-answer may exceed `0.85`. If the auto-answer would make ambiguity cross the resolved threshold, ask the user for threshold-crossing confirmation before Phase 4: present the tentative assumption and require explicit confirmation, revision, or continued questioning. On architect failure or invalid response, continue with the user's opt-out as an unresolved gap, increment `architect_failures`, and do not block the interview.
+
 ### Step 2c: Score Ambiguity
 
 After receiving the user's answer, score clarity across all dimensions.
 
+If the round used an auto-answer, include the architect answer, rationale, confidence, and uncertainty in the scoring prompt. Apply the Step 2b′ clarity cap mechanically before calculating ambiguity, and treat any low-confidence or insufficient-context auto-answer as an unresolved gap rather than user-confirmed truth.
+
 **Scoring prompt** (use opus model, temperature 0.1 for consistency):
 
 ```
@@ -355,7 +383,7 @@ Round {n} complete.
 
 ### Step 2e: Update State
 
-Update interview state with the new round, global scores, per-component `topology.components[].clarity_scores`, `topology.components[].weakest_dimension`, ontology snapshot, and `topology.last_targeted_component_id` via `gjc state write`; never patch `.gjc/state` directly unless an explicit force override is active.
+Update interview state with the new round, global scores, per-component `topology.components[].clarity_scores`, `topology.components[].weakest_dimension`, ontology snapshot, `topology.last_targeted_component_id`, `auto_researched_rounds`, `auto_answered_rounds`, and `architect_failures` via `gjc state write`; never patch `.gjc/state` directly unless an explicit force override is active.
 
 ### Step 2f: Check Soft Limits
 
@@ -408,6 +436,9 @@ Spec structure:
 - Threshold Source: <resolvedThresholdSource>
 - Initial Context Summarized: {yes|no}
 - Status: {PASSED | BELOW_THRESHOLD_EARLY_EXIT}
+- Auto-Researched Rounds: {auto_researched_rounds}
+- Auto-Answered Rounds: {auto_answered_rounds}
+- Architect Failures: {architect_failures}
 
 ## Clarity Breakdown
 | Dimension | Score | Weight | Weighted |
@@ -569,6 +600,8 @@ Skipping any stage is possible but reduces quality assurance:
 - Use the GJC workflow CLI to save the final spec at `.gjc/specs/deep-interview-{slug}.md` exactly; do not use `write`, `edit`, or `ast_edit` directly on `.gjc/` paths without force override.
 - Use public GJC workflow entrypoints to bridge to ralplan/team only after explicit execution approval — never implement directly
 - Challenge agent modes are prompt injections, not separate agent spawns
+- Use internal fragment auto-modes only at their documented hooks: `auto-research-greenfield.md` between Step 2a and 2b for greenfield `research: true` questions, and `auto-answer-uncertain.md` as Step 2b′ after `ask` resolves and before scoring.
+- Fragment auto-modes are loaded on demand as `kind: "skill-fragment"`; they are not public workflow skills, not slash-command/discoverable, and not `skill://` registrations.
 </Tool_Usage>
 
 <Examples>
@@ -703,6 +736,8 @@ Why bad: 45% ambiguity means nearly half the requirements are unclear. The mathe
 - [ ] Multi-component interviews rotate targeting across active components when N > 1
 - [ ] Spec includes Topology section with confirmed active components and user-confirmed deferrals
 - [ ] Spec includes Ontology (Key Entities) table and Ontology Convergence section
+- [ ] Internal auto-mode fragments, when used, were loaded only on demand as non-public `kind: "skill-fragment"` prompts; responses were validated, failures incremented `architect_failures`, and final metadata includes `auto_researched_rounds`, `auto_answered_rounds`, and `architect_failures`
+- [ ] Auto-answer threshold crossing, if any, received explicit user confirmation before spec crystallization
 </Final_Checklist>
 
 <Advanced>