salmon-loop 0.2.13 → 0.2.16

package/dist/cli/headless/stream-json-protocol.js

@@ -1,4 +1,5 @@
 import { getExitCode } from '../../core/facades/cli-headless.js';
+import { HEADLESS_NATIVE_STREAM_PROTOCOL_VERSION, normalizeHeadlessWarnings, } from './protocol-metadata.js';
 function toIso(date) {
     return date.toISOString();
 }
@@ -27,6 +28,8 @@ function encodeEnvelope(params) {
     return dropUndefined({
         uuid: params.uuid,
         session_id: params.sessionId,
+        protocol_version: HEADLESS_NATIVE_STREAM_PROTOCOL_VERSION,
+        event_seq: params.eventSeq,
         event: params.event,
         parent_tool_use_id: params.parentToolUseId,
     });
@@ -42,6 +45,7 @@ export function encodeStreamStart(params) {
             repo_path: params.repoPath,
             instruction: params.instruction,
         }),
+        eventSeq: params.eventSeq,
     });
 }
 export function encodeStreamEvent(params) {
@@ -53,6 +57,7 @@ export function encodeStreamEvent(params) {
             ...params.event,
             timestamp: toIso(params.at),
         }),
+        eventSeq: params.eventSeq,
     });
 }
 export function encodeStreamLoopEvent(params) {
@@ -65,10 +70,30 @@ export function encodeStreamLoopEvent(params) {
             ...mapLoopEventToJson(params.event),
             timestamp: toIso(params.event.timestamp),
         }),
+        eventSeq: params.eventSeq,
     });
 }
 export function encodeStreamResult(params) {
     const exitCode = getStreamExitCode(params.loopResult);
+    const warnings = normalizeHeadlessWarnings(params.warnings);
+    const patchArtifact = params.loopResult.benchmarkPatchArtifact
+        ? {
+            kind: params.loopResult.benchmarkPatchArtifact.kind,
+            path: params.loopResult.benchmarkPatchArtifact.path,
+            sha256: params.loopResult.benchmarkPatchArtifact.sha256,
+            bytes: params.loopResult.benchmarkPatchArtifact.bytes,
+            changed_files: params.loopResult.benchmarkPatchArtifact.changedFiles,
+            is_empty: params.loopResult.benchmarkPatchArtifact.isEmpty,
+        }
+        : undefined;
+    const benchmarkArtifact = params.loopResult.benchmarkArtifact
+        ? {
+            provider: params.loopResult.benchmarkArtifact.provider,
+            instance_id: params.loopResult.benchmarkArtifact.instanceId,
+            model_name_or_path: params.loopResult.benchmarkArtifact.modelNameOrPath,
+            predictions_path: params.loopResult.benchmarkArtifact.predictionsPath,
+        }
+        : undefined;
     return encodeEnvelope({
         uuid: params.uuid,
         sessionId: params.sessionId,
@@ -83,17 +108,21 @@ export function encodeStreamResult(params) {
             safe_hint: params.loopResult.safeHint ?? params.loopResult.reason,
             remediation_steps: params.loopResult.remediationSteps ?? [],
             attempts: params.loopResult.attempts,
-            changed_files: params.loopResult.changedFiles,
+            changed_files: params.loopResult.changedFiles ?? [],
+            patch_artifact: patchArtifact,
+            benchmark_artifact: benchmarkArtifact,
             audit_path: params.loopResult.auditPath,
             error_code: params.loopResult.errorCode,
             authorization_summary: params.loopResult.authorizationSummary,
             result: params.resultText,
+            warnings,
             run_end: {
                 success: Boolean(params.loopResult.success),
                 exit_code: exitCode,
                 timestamp: toIso(params.at),
             },
         }),
+        eventSeq: params.eventSeq,
     });
 }
 export function encodeStreamFailure(params) {
@@ -103,12 +132,14 @@ export function encodeStreamFailure(params) {
         event: {
             type: 'error',
             timestamp: toIso(params.at),
+            audit_path: params.auditPath,
             error: dropUndefined({
                 name: params.name,
                 message: params.message,
                 stack: params.stack,
             }),
         },
+        eventSeq: params.eventSeq,
     });
 }
 export function encodeStreamCrash(params) {
@@ -119,6 +150,7 @@ export function encodeStreamCrash(params) {
         message: params.error.message,
         name: params.error.name,
         stack: params.error.stack,
+        eventSeq: params.eventSeq,
     });
 }
 export function encodeStreamEnd(params) {
@@ -131,6 +163,7 @@ export function encodeStreamEnd(params) {
             success: params.success,
             exit_code: params.exitCode,
         },
+        eventSeq: params.eventSeq,
     });
 }
 //# sourceMappingURL=stream-json-protocol.js.map

package/dist/cli/index.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env bun
-// 1. MUST be the very first lines to force all chalk instances (even in node_modules)
-// to use color support before they complete initialization.
-process.env.FORCE_COLOR = '3';
+import { detectHeadlessOutputFromArgv, shouldForceColorForArgv, } from './argv/headless-detection.js';
+const headlessOutput = Boolean(detectHeadlessOutputFromArgv(process.argv).outputFormat);
+if (!headlessOutput && shouldForceColorForArgv(process.argv)) {
+    process.env.FORCE_COLOR = '3';
+}
 import 'dotenv/config';
-import { runCli } from './run-cli.js';
+const { runCli } = await import('./run-cli.js');
 await runCli(process.argv);
 //# sourceMappingURL=index.js.map

package/dist/cli/locales/en.js

@@ -3,7 +3,7 @@ export const en = {
     programDescription: 'A minimal viable loop for automated code patching',
     runDescription: 'Run the salmon-loop',
     contextDescription: 'Build and print the context prompt (no LLM call)',
-    serveDescription: 'Start the A2A + sidecar server',
+    serveDescription: 'Start the A2A server and ACP stdio bridge',
     serveAcpDescription: 'Start the agent-client-protocol (ACP) stdio server only',
     noColorOption: 'Disable colored output in logs',
     // Chat mode
@@ -74,6 +74,7 @@ export const en = {
     commandLlmOutput: 'Set which LLM sections are shown in the UI (advanced)',
     commandMode: 'Set permission mode (interactive|yolo) and save to config',
     commandLogMode: 'Set UI verbosity (quiet|normal|debug) and save to config',
+    commandFlowMode: 'Set the current chat flow mode for this session',
     commandConfig: 'Settings hub (mode, log-mode, view, output, allowlist)',
     commandAuth: 'Manage tool allowlist',
     commandParallel: 'Manage parallel plans',
@@ -120,6 +121,25 @@ export const en = {
     modeUpdated: (mode) => `Permission mode updated: ${mode}`,
     modePersisted: (path) => `Permission mode saved to ${path}`,
     modePersistFailed: (error) => `Failed to save permission mode: ${error}`,
+    flowModeUsage: 'Usage: /flow-mode <patch|review|debug|research|answer|autopilot>',
+    flowModeSuggestion: (mode) => {
+        if (mode === 'patch')
+            return 'Patch code and run verification';
+        if (mode === 'review')
+            return 'Analyze code without modifying files';
+        if (mode === 'debug')
+            return 'Investigate issues, then patch and verify';
+        if (mode === 'research')
+            return 'Research the codebase and summarize findings';
+        if (mode === 'answer')
+            return 'Answer directly without modifying files';
+        if (mode === 'autopilot')
+            return 'Let SalmonLoop choose the appropriate flow';
+        return `Set flow mode to ${mode}`;
+    },
+    flowModeCurrent: (mode) => `Current chat flow mode: ${mode}`,
+    flowModeInvalid: (mode) => `Invalid flow mode: ${mode}. Expected one of: patch, review, debug, research, answer, autopilot.`,
+    flowModeUpdated: (mode) => `Chat flow mode updated: ${mode}`,
     logModeUsage: 'Usage: /log-mode <quiet|normal|debug>',
     logModeSuggestion: (mode) => {
         if (mode === 'quiet')
@@ -159,11 +179,9 @@ export const en = {
     a2aPortOption: 'A2A listen port (default: 7431)',
     a2aTokenOption: 'Bearer token for A2A auth (repeatable)',
     acpStdioDisableOption: 'Disable agent-client-protocol (ACP) stdio server',
-    sidecarSocketOption: 'UDS path for the sidecar UI server',
-    sidecarAllowConditionalOption: 'Expose conditional sidecar routes (use with care)',
     acpStdioStarted: (port) => `ACP (agent-client-protocol) stdio enabled; port ${port}`,
     invalidA2APort: (value) => `Invalid A2A port: ${value}`,
-    serveStarted: (host, port, socket) => `A2A listening on ${host}:${port}; sidecar socket at ${socket}`,
+    serveStarted: (host, port) => `A2A listening on ${host}:${port}`,
     configAllowlistUsage: 'Usage: /config allowlist <list|add|remove|clear|hash|reload> [scope] [tool] [phase] [args=<hash>] [effects=a,b] [deny]',
     authUsage: 'Usage: /allowlist <list|add|remove|clear|hash|reload> [scope] [tool] [phase] [args=<hash>] [effects=a,b] [deny]',
     authSubcommandHint: (sub) => `Allowlist ${sub} command`,
@@ -243,6 +261,10 @@ export const en = {
     includePartialMessagesOption: 'Include partial message streaming events in stream-json output (alias for --stream-output).',
     outputFormatOption: 'Output format (text, json, stream-json)',
     outputProfileOption: 'Output profile for stream-json (native, anthropic, openai). Only valid with --output-format stream-json.',
+    exportPatchOption: 'Write the final workspace git unified diff to a patch file after the run completes.',
+    sweBenchInstanceIdOption: 'SWE-bench instance_id to include when writing a predictions JSONL record.',
+    sweBenchModelNameOption: 'SWE-bench model_name_or_path to include when writing a predictions JSONL record.',
+    sweBenchPredictionsOption: 'Append a SWE-bench predictions JSONL record containing instance_id, model_name_or_path, and model_patch.',
     headlessIncludeToolInputOption: 'Headless only: include (redacted) tool input in stream-json output. Only valid with --output-format stream-json.',
     headlessIncludeToolOutputOption: 'Headless only: include tool output summary in stream-json output. Only valid with --output-format stream-json.',
     headlessIncludeAuthorizationDecisionsOption: 'Headless only: include tool authorization decisions in headless output. Only valid with --output-format json or stream-json.',
@@ -252,7 +274,7 @@ export const en = {
     auditScopeOption: 'Audit log scope (repo, user)',
     contextDiffScopeOption: 'Diff scope for context (primary, ast_related)',
     contextBudgetCharsOption: 'Context budget in characters (e.g., 30000)',
-    actModeOption: 'Flow mode to run (patch, review, debug, research)',
+    actModeOption: 'Flow mode to run (patch, review, debug, research, answer, autopilot)',
     // Error messages
     fileSelectionConflict: '--file and --selection are mutually exclusive',
     instructionRequired: '--instruction is required',
@@ -262,10 +284,12 @@ export const en = {
     jsonSchemaRequiresJsonOutput: '--json-schema is only valid when --output-format is set to "json".',
     jsonSchemaLoadFailed: (msg) => `Failed to load JSON schema: ${msg}.`,
     structuredOutputSchemaFailed: 'Structured output failed schema validation.',
-    invalidActMode: (mode) => `Invalid --act-mode "${mode}". Expected "patch", "review", "debug", or "research".`,
+    invalidActMode: (mode) => `Invalid --act-mode "${mode}". Expected "patch", "review", "debug", "research", "answer", or "autopilot".`,
     invalidEnvironmentMode: (mode) => `Invalid --environment-mode "${mode}". Expected "strict" or "parity".`,
     invalidOutputFormat: (format) => `Invalid --output-format "${format}". Expected "text", "stream-json", or "json".`,
     invalidOutputProfile: (profile) => `Invalid --output-profile "${profile}". Expected "native", "anthropic", or "openai".`,
+    sweBenchInstanceRequired: '--swe-bench-predictions requires --swe-bench-instance-id.',
+    sweBenchModelRequired: '--swe-bench-predictions requires --swe-bench-model-name.',
     invalidAuditScope: (scope) => `Invalid --audit-scope "${scope}". Expected "repo" or "user".`,
     headlessToolPayloadRequiresStreamJson: '--headless-include-tool-input/--headless-include-tool-output are only valid when --output-format is set to "stream-json".',
     headlessToolPayloadNotSupportedWithOpenAiProfile: '--headless-include-tool-input/--headless-include-tool-output are not supported with --output-profile "openai".',

package/dist/cli/program-bootstrap.js

@@ -2,10 +2,15 @@ import chalk from 'chalk';
 import { Command } from 'commander';
 import { initializeRuntime } from '../core/facades/cli-program-bootstrap.js';
 import { text } from './locales/index.js';
-export function bootstrapProgram() {
+export function bootstrapProgram(options = {}) {
     initializeRuntime();
-    // Force global chalk level for all output paths.
-    chalk.level = 3;
+    if (!options.headlessDetection?.outputFormat && process.env.NO_COLOR === undefined) {
+        // Force global chalk level for interactive output paths.
+        chalk.level = 3;
+    }
+    else {
+        chalk.level = 0;
+    }
     const program = new Command();
     program.exitOverride();
     program

package/dist/cli/program-commands.js

@@ -22,7 +22,7 @@ export function registerProgramCommands(program) {
         .option('--force-reset', text.cli.forceResetOption)
         .option('--validate', text.cli.validateOption)
         .option('--preflight-policy <policy>', text.cli.preflightPolicyOption, 'lenient')
-        .option('--act-mode <mode>', text.cli.actModeOption, 'patch')
+        .option('--act-mode <mode>', text.cli.actModeOption, 'autopilot')
         .option('--apply-back-on-dirty <mode>', text.cli.applyBackOnDirtyOption, '3way')
         .option('--environment-mode <mode>', text.cli.environmentModeOption, 'strict')
         .option('--worktree-prepare <command>', text.cli.worktreePrepareOption)
@@ -30,6 +30,10 @@ export function registerProgramCommands(program) {
         .option('--include-partial-messages', text.cli.includePartialMessagesOption)
         .option('--output-format <format>', text.cli.outputFormatOption, 'text')
         .option('--output-profile <profile>', text.cli.outputProfileOption)
+        .option('--export-patch <path>', text.cli.exportPatchOption)
+        .option('--swe-bench-instance-id <id>', text.cli.sweBenchInstanceIdOption)
+        .option('--swe-bench-model-name <name>', text.cli.sweBenchModelNameOption)
+        .option('--swe-bench-predictions <path>', text.cli.sweBenchPredictionsOption)
         .option('--headless-include-tool-input', text.cli.headlessIncludeToolInputOption)
         .option('--headless-include-tool-output', text.cli.headlessIncludeToolOutputOption)
         .option('--allow-outside-cache-root', text.cli.allowOutsideCacheRootOption)

package/dist/cli/reporters/anthropic-stream.js

@@ -8,13 +8,18 @@ export class AnthropicStreamReporter {
     repoPath;
     sessionId;
     writer;
+    includeToolInput;
     lastTextResult;
-    assembler = new StreamAssembler();
+    assembler;
     constructor(options = {}) {
         this.mode = options.mode ?? 'run';
         this.repoPath = options.repoPath;
         this.sessionId = options.sessionId ?? randomUUID();
         this.writer = options.writer ?? createStdoutWriter();
+        this.includeToolInput = options.includeToolInput ?? false;
+        this.assembler = new StreamAssembler({
+            deferToolRequestsUntilExecutionInput: this.includeToolInput,
+        });
     }
     onStart(instruction) {
         this.emit(encodeAnthropicStart({
@@ -40,6 +45,7 @@ export class AnthropicStreamReporter {
                 const lines = encodeNormalizedToAnthropicStreamLines({
                     sessionId: this.sessionId,
                     event: normalizedEvent,
+                    includeToolInput: this.includeToolInput,
                 });
                 for (const line of lines)
                     this.emit(line);

package/dist/cli/reporters/json.js

@@ -7,6 +7,7 @@ export class JsonReporter {
     sessionId;
     getStructuredOutput;
     getPayloadOverrides;
+    getWarnings;
     now;
     writer;
     startedAt = null;
@@ -18,6 +19,7 @@ export class JsonReporter {
         this.sessionId = options.sessionId ?? randomUUID();
         this.getStructuredOutput = options.getStructuredOutput;
         this.getPayloadOverrides = options.getPayloadOverrides;
+        this.getWarnings = options.getWarnings;
         this.now = options.now ?? (() => new Date());
         this.writer = options.writer ?? createStdoutWriter();
     }
@@ -48,6 +50,7 @@ export class JsonReporter {
             structuredOutput,
             loopResult: result,
             overrides,
+            warnings: this.getWarnings?.(),
         });
         this.writer.writeJsonLine(payload);
     }
@@ -62,6 +65,7 @@ export class JsonReporter {
             startedAt,
             endedAt,
             error,
+            warnings: this.getWarnings?.(),
         });
         this.writer.writeJsonLine(payload);
     }

package/dist/cli/reporters/stream-json.js

@@ -10,8 +10,11 @@ export class StreamJsonReporter {
     now;
     uuid;
     writer;
+    getWarnings;
     lastTextResult;
-    assembler = new StreamAssembler();
+    nextEventSeq = 0;
+    assembler;
+    includeToolInput;
     constructor(options = {}) {
         this.mode = options.mode ?? 'run';
         this.repoPath = options.repoPath;
@@ -19,6 +22,11 @@ export class StreamJsonReporter {
         this.now = options.now ?? (() => new Date());
         this.uuid = options.uuid ?? randomUUID;
         this.writer = options.writer ?? createStdoutWriter();
+        this.getWarnings = options.getWarnings;
+        this.includeToolInput = options.includeToolInput ?? false;
+        this.assembler = new StreamAssembler({
+            deferToolRequestsUntilExecutionInput: this.includeToolInput,
+        });
     }
     onStart(instruction) {
         this.emit(encodeStreamStart({
@@ -47,6 +55,7 @@ export class StreamJsonReporter {
                     sessionId: this.sessionId,
                     uuid: this.uuid,
                     event: normalizedEvent,
+                    includeToolInput: this.includeToolInput,
                 });
                 for (const line of lines)
                     this.emit(line);
@@ -76,6 +85,7 @@ export class StreamJsonReporter {
             loopResult: result,
             at,
             resultText: this.lastTextResult,
+            warnings: this.getWarnings?.(),
         });
         this.emit(resultLine);
         const exitCode = getStreamExitCode(result);
@@ -88,6 +98,7 @@ export class StreamJsonReporter {
         }));
     }
     onError(error) {
+        const auditPath = typeof error.auditPath === 'string' ? error.auditPath : undefined;
         this.emit(encodeStreamFailure({
             uuid: this.uuid(),
             sessionId: this.sessionId,
@@ -95,6 +106,7 @@ export class StreamJsonReporter {
             message: error.message,
             name: error.name,
             stack: error.stack,
+            auditPath,
         }));
         this.emit(encodeStreamEnd({
             uuid: this.uuid(),
@@ -105,7 +117,10 @@ export class StreamJsonReporter {
         }));
     }
     emit(line) {
-        this.writer.writeJsonLine(line);
+        this.writer.writeJsonLine({
+            ...line,
+            event_seq: line.event_seq ?? this.nextEventSeq++,
+        });
     }
 }
 //# sourceMappingURL=stream-json.js.map

package/dist/cli/run-cli.js

@@ -1,17 +1,19 @@
+import { detectHeadlessOutputFromArgv } from './argv/headless-detection.js';
 import { createCliRuntimeContext } from './cli-runtime-context.js';
 import { bootstrapProgram } from './program-bootstrap.js';
 import { registerProgramCommands } from './program-commands.js';
 import { configureGlobalProgramOptions } from './program-options.js';
 import { configureProgramOutputForHeadless } from './program-output-mode.js';
 import { parseProgramOrExit } from './program-parse.js';
-export function buildCliProgram() {
-    const program = bootstrapProgram();
+export function buildCliProgram(argv = process.argv) {
+    const headlessDetection = detectHeadlessOutputFromArgv(argv);
+    const program = bootstrapProgram({ headlessDetection });
     configureGlobalProgramOptions(program);
     registerProgramCommands(program);
     return program;
 }
 export function createCliContextFromArgv(argv) {
-    const program = buildCliProgram();
+    const program = buildCliProgram(argv);
     return createCliRuntimeContext(program, argv);
 }
 export async function executeCliContext(context) {

package/dist/cli/slash/runtime.js

@@ -5,14 +5,22 @@ import { text } from '../locales/index.js';
 function isSafeSkillId(id) {
     return /^[a-z0-9][a-z0-9-_]*$/i.test(id);
 }
-function skillToSlashSpec(skill) {
-    const id = String(skill.id || '').trim();
+/**
+ * Build a SlashCommandSpec from a Tier 1 catalog entry (lightweight metadata).
+ *
+ * This supports the AgentSkills progressive disclosure pattern: only name and
+ * description are needed at startup to populate the slash command registry.
+ * Full skill content is loaded on demand via SkillLoader.activateSkill().
+ *
+ * @see https://agentskills.io/specification — Progressive disclosure
+ */
+function catalogEntryToSlashSpec(entry) {
+    const id = String(entry.id || '').trim();
     if (!id || !isSafeSkillId(id))
         return null;
     return {
         name: `/${id}`,
-        description: skill.metadata?.description || `Skill: ${id}`,
-        hidden: skill.metadata?.userInvocable === false,
+        description: entry.description || `Skill: ${id}`,
         order: 220,
     };
 }
@@ -28,11 +36,15 @@ function commandToSlashSpec(cmd) {
 export async function createCliSlashRuntime(options) {
     const skillLoader = new SkillLoader({
         repoRoot: options.repoRoot,
-        useDefaults: options.skillDiscovery?.useDefaults,
         extraPaths: options.skillDiscovery?.paths,
     });
-    const skills = await skillLoader.initialize();
-    const skillSpecs = skills.map(skillToSlashSpec).filter((s) => Boolean(s));
+    // Tier 1: Load lightweight catalog (name + description only, ~50-100 tokens per skill).
+    // Full skill content is loaded on demand via activateSkill() (Tier 2).
+    // @see https://agentskills.io/specification — Progressive disclosure
+    const catalog = await skillLoader.loadCatalog();
+    const skillSpecs = catalog
+        .map(catalogEntryToSlashSpec)
+        .filter((s) => Boolean(s));
     const commandSpecs = options.baseCommands.map(commandToSlashSpec);
     // /help is best-effort and must reflect the effective registry (including skills).
     const helpSpec = {
@@ -51,11 +63,11 @@ export async function createCliSlashRuntime(options) {
         }
     }
     const skillBySlash = new Map();
-    for (const skill of skills) {
-        const spec = skillToSlashSpec(skill);
+    for (const entry of catalog) {
+        const spec = catalogEntryToSlashSpec(entry);
         if (!spec)
             continue;
-        skillBySlash.set(spec.name.toLowerCase(), skill);
+        skillBySlash.set(spec.name.toLowerCase(), entry);
     }
     const handlers = {
         getHandler(commandName) {
@@ -115,10 +127,13 @@ export async function createCliSlashRuntime(options) {
                         : undefined,
                 };
             }
-            const skill = skillBySlash.get(normalized);
-            if (skill) {
+            const catalogEntry = skillBySlash.get(normalized);
+            if (catalogEntry) {
                 return {
                     execute: async (req) => {
+                        // Tier 2: Activate skill on demand — load full SKILL.md content.
+                        // @see https://agentskills.io/specification — Progressive disclosure
+                        const skill = await skillLoader.activateSkill(catalogEntry.id);
                         const meta = (req.meta ?? {});
                         const signal = meta?.signal;
                         // Prepare an isolated worktree environment for governed shell execution.

package/dist/cli/ui/components/CommandInput.js

@@ -9,6 +9,7 @@ import { useCommandSuggestions } from '../hooks/useCommandSuggestions.js';
 import { useInputHistory } from '../hooks/useInputHistory.js';
 import { rejectSelection, resolveSelection } from '../selection/bus.js';
 import { useUIStore } from '../store/context.js';
+import { COLORS } from '../styles/theme.js';
 import { CommandSuggestionList } from './CommandSuggestionList.js';
 export const CommandInput = ({ value, onChange, onSubmit, placeholder, getSuggestions, findCommand, }) => {
     const { state, dispatch } = useUIStore();
@@ -185,16 +186,19 @@ export const CommandInput = ({ value, onChange, onSubmit, placeholder, getSugges
                                 : en.gui.selectionPlaceholder
                             : isIntercepting && activeChallenge
                                 ? en.gui.confirmationChallenge(activeChallenge)
-                                : placeholder }, inputKey), ghostText && (_jsx(Text, { color: "gray", dimColor: true, children: ghostText }))] }), isIntercepting && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellow", paddingX: 1, children: [_jsx(Text, { color: "yellow", bold: true, children: isSelecting
+                                : placeholder }, inputKey), ghostText && (_jsx(Text, { color: COLORS.text.muted, dimColor: true, children: ghostText }))] }), isIntercepting && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: COLORS.semantic.yellow, paddingX: 1, children: [_jsx(Text, { color: COLORS.semantic.yellow, bold: true, children: isSelecting
                             ? pendingSelection?.title
                             : isAuthorizing
                                 ? en.gui.authorizationTitle
-                                : en.gui.confirmationTitle }), !isSelecting && (_jsx(Text, { color: "white", children: isAuthorizing ? pendingAuthorization?.message : pendingConfirmation?.message })), _jsx(Text, { color: "gray", dimColor: true, children: isSelecting
+                                : en.gui.confirmationTitle }), !isSelecting && (_jsx(Text, { color: COLORS.text.primary, children: isAuthorizing ? pendingAuthorization?.message : pendingConfirmation?.message })), _jsx(Text, { color: COLORS.text.muted, dimColor: true, children: isSelecting
                             ? isMultiSelecting
                                 ? en.gui.selectionHintMulti
                                 : en.gui.selectionHint
                             : isAuthorizing
                                 ? en.gui.authorizationWarning
-                                : en.gui.highRiskWarning }), isAuthorizing && (_jsx(Text, { color: "gray", dimColor: true, children: en.gui.authorizationHint })), isSelecting && pendingSelection && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: pendingSelection.items.map((item, idx) => (_jsxs(Text, { color: idx === selectionIndex ? 'green' : 'gray', children: [isMultiSelecting && (_jsx(Text, { color: selectedItems.includes(item.id) ? 'green' : 'gray', children: selectedItems.includes(item.id) ? '[x] ' : '[ ] ' })), item.label, item.description ? ` - ${item.description}` : ''] }, item.id))) }))] })), !isIntercepting && suggestions.length > 0 && !isListClosed && (_jsx(CommandSuggestionList, { suggestions: visibleSuggestions, selectedIndex: selectedIndex - startIndex, parentCommand: activeCommand }))] }));
+                                : en.gui.highRiskWarning }), isAuthorizing && (_jsx(Text, { color: COLORS.text.muted, dimColor: true, children: en.gui.authorizationHint })), isSelecting && pendingSelection && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: pendingSelection.items.map((item, idx) => {
+                            const isSelected = idx === selectionIndex;
+                            return (_jsxs(Text, { color: isSelected ? COLORS.semantic.cyan : COLORS.text.muted, children: [isSelected ? '❯ ' : '  ', isMultiSelecting && (_jsx(Text, { color: selectedItems.includes(item.id) ? COLORS.semantic.cyan : COLORS.text.muted, children: selectedItems.includes(item.id) ? '[x] ' : '[ ] ' })), item.label, item.description ? ` - ${item.description}` : ''] }, item.id));
+                        }) }))] })), !isIntercepting && suggestions.length > 0 && !isListClosed && (_jsx(CommandSuggestionList, { suggestions: visibleSuggestions, selectedIndex: selectedIndex - startIndex, parentCommand: activeCommand }))] }));
 };
 //# sourceMappingURL=CommandInput.js.map

package/dist/cli/ui/components/CommandSuggestionList.js

@@ -14,7 +14,7 @@ export const CommandSuggestionList = ({ suggestions, selectedIndex, parentComman
     return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: COLORS.border.subtle, marginTop: 0, marginBottom: 0, paddingX: 0, width: "100%", children: [_jsx(Box, { flexDirection: "column", paddingY: 0, children: suggestions.map((item, index) => {
                     const isSelected = index === selectedIndex;
                     const hasSubcommands = !!item.command?.subcommands?.length;
-                    return (_jsxs(Box, { flexDirection: "row", paddingX: 1, children: [_jsx(Box, { width: 2, children: _jsx(Text, { color: COLORS.semantic.salmon, children: isSelected ? '│ ' : '  ' }) }), _jsx(Box, { width: maxNameLength + 4, children: _jsx(Text, { color: isSelected ? COLORS.semantic.cyan : COLORS.semantic.blue, bold: isSelected, children: item.name }) }), _jsx(Box, { width: 2, marginRight: 1, children: hasSubcommands ? _jsx(Text, { color: COLORS.text.muted, children: " " }) : _jsx(Text, { children: " " }) }), _jsx(Box, { flexGrow: 1, children: _jsx(Text, { color: isSelected ? COLORS.text.primary : COLORS.text.muted, wrap: "truncate", children: item.description }) })] }, `${item.name}-${index}`));
+                    return (_jsxs(Box, { flexDirection: "row", paddingX: 1, children: [_jsx(Box, { width: 2, children: _jsx(Text, { color: COLORS.semantic.salmon, children: isSelected ? '│ ' : '  ' }) }), _jsx(Box, { width: maxNameLength + 4, children: _jsx(Text, { color: isSelected ? COLORS.semantic.cyan : COLORS.semantic.blue, bold: isSelected, children: item.name }) }), _jsx(Box, { width: 2, marginRight: 1, children: hasSubcommands ? _jsx(Text, { color: COLORS.text.muted, children: "\u203A" }) : _jsx(Text, { children: " " }) }), _jsx(Box, { flexGrow: 1, children: _jsx(Text, { color: isSelected ? COLORS.text.primary : COLORS.text.muted, wrap: "truncate", children: item.description }) })] }, `${item.name}-${index}`));
                 }) }), suggestions[selectedIndex]?.command?.usage && (_jsxs(Box, { flexDirection: "row", borderStyle: "single", borderTop: true, borderLeft: false, borderRight: false, borderBottom: false, borderColor: COLORS.border.subtle, paddingX: 1, paddingY: 0, children: [_jsx(Text, { color: COLORS.semantic.blue, children: "TIP: " }), _jsx(Text, { color: COLORS.text.muted, children: "Usage: " }), _jsx(Text, { color: COLORS.text.primary, children: suggestions[selectedIndex].command?.usage })] })), _jsxs(Box, { flexDirection: "row", borderStyle: "single", borderTop: true, borderLeft: false, borderRight: false, borderBottom: false, borderColor: COLORS.border.subtle, paddingX: 1, paddingY: 0, justifyContent: "space-between", children: [_jsxs(Box, { children: [_jsx(Text, { color: COLORS.semantic.salmon, children: "\u2502 " }), _jsx(Text, { color: COLORS.semantic.blue, bold: true, children: title })] }), _jsx(Box, { children: _jsx(Text, { color: COLORS.text.muted, dimColor: true, children: "\u2191\u2193 nav \u00B7 \u23CE select \u00B7 esc close" }) })] })] }));
 };
 //# sourceMappingURL=CommandSuggestionList.js.map

package/dist/cli/utils/command-option-source.js

@@ -0,0 +1,13 @@
+export function getOptionValueSourceWithGlobalFallback(command, optionName) {
+    if (typeof command.getOptionValueSource === 'function') {
+        const direct = command.getOptionValueSource(optionName);
+        if (direct)
+            return direct;
+    }
+    const parent = command.parent;
+    if (parent && typeof parent.getOptionValueSource === 'function') {
+        return parent.getOptionValueSource(optionName);
+    }
+    return undefined;
+}
+//# sourceMappingURL=command-option-source.js.map

package/dist/cli/utils/verify-resolver.js

@@ -1,4 +1,4 @@
-import { getLogger } from '../../core/facades/cli-observability.js';
+import { tryGetLogger } from '../../core/facades/cli-observability.js';
 import { text } from '../../locales/index.js';
 import { autoDetectVerifyCommand } from './detectors/index.js';
 /**
@@ -8,11 +8,11 @@ import { autoDetectVerifyCommand } from './detectors/index.js';
  * 3. Config file command -> "cmd"
  * 4. Auto-detection -> "detected-cmd"
  */
-export async function resolveVerifyOption(repoPath, cliVerify, configVerify) {
+export async function resolveVerifyOption(repoPath, cliVerify, configVerify, options = {}) {
     // 1. Explicitly disabled via --no-verify
     // Commander sets options.verify to false when --no-verify is used
     if (cliVerify === false) {
-        getLogger().debug(text.verify.explicitlyDisabled);
+        tryGetLogger()?.debug(text.verify.explicitlyDisabled);
         return undefined;
     }
     // 2. Explicitly provided via CLI --verify "cmd"
@@ -26,7 +26,11 @@ export async function resolveVerifyOption(repoPath, cliVerify, configVerify) {
     // 4. Auto-detect
     const detected = await autoDetectVerifyCommand(repoPath);
     if (detected) {
-        getLogger().info(text.verify.autoDetected(detected));
+        const logger = tryGetLogger();
+        if (options.quiet)
+            logger?.debug(text.verify.autoDetected(detected));
+        else
+            logger?.info(text.verify.autoDetected(detected));
         return detected;
     }
     return undefined;

package/dist/cli/utils/worktree-prepare-resolver.js

@@ -1,7 +1,7 @@
-import { getLogger } from '../../core/facades/cli-utils-worktree.js';
+import { tryGetLogger } from '../../core/facades/cli-utils-worktree.js';
 import { text } from '../../locales/index.js';
 import { autoDetectWorktreePrepareCommand } from './detectors/index.js';
-export async function resolveWorktreePrepareOption(repoPath, strategy, cliWorktreePrepare) {
+export async function resolveWorktreePrepareOption(repoPath, strategy, cliWorktreePrepare, options = {}) {
     if (typeof cliWorktreePrepare === 'string' && cliWorktreePrepare.trim()) {
         return cliWorktreePrepare;
     }
@@ -10,7 +10,11 @@ export async function resolveWorktreePrepareOption(repoPath, strategy, cliWorktr
     }
     const detected = await autoDetectWorktreePrepareCommand(repoPath);
     if (detected) {
-        getLogger().info(text.verify.autoDetectedWorktreePrepare(detected));
+        const logger = tryGetLogger();
+        if (options.quiet)
+            logger?.debug(text.verify.autoDetectedWorktreePrepare(detected));
+        else
+            logger?.info(text.verify.autoDetectedWorktreePrepare(detected));
         return detected;
     }
     return undefined;

package/dist/core/adapters/fs/file-adapter.js

@@ -73,6 +73,12 @@ export class FileAdapter {
     async stat(filePath) {
         return fs.stat(filePath);
     }
+    /**
+     * Get file stats without following symlinks.
+     */
+    async lstat(filePath) {
+        return fs.lstat(filePath);
+    }
     /**
      * Create directory recursively
      */

package/dist/core/adapters/fs/filesystem.js

@@ -1,3 +1,4 @@
+import { resolveExecutionProfile } from '../../runtime/execution-profile.js';
 import { FileAdapter } from './file-adapter.js';
 import { ReadOnlyFileSystem } from './readonly-filesystem.js';
 class FileAdapterFileSystem {
@@ -23,7 +24,7 @@ class FileAdapterFileSystem {
  * Review mode returns a ReadOnlyFileSystem to block writes.
  */
 export function createFileSystemAdapter(mode, realFs = new FileAdapterFileSystem()) {
-    if (mode === 'review' || mode === 'research' || mode === 'answer') {
+    if (resolveExecutionProfile(mode).readOnly) {
         return new ReadOnlyFileSystem(realFs);
     }
     return realFs;