claude-use 11.28.0 → 11.29.0

package/dist/cli.cjs

@@ -28687,20 +28687,53 @@ var init_supervisor = __esm({
   }
 });
 
-// src/logStyle.ts
-function styledDiagnostic(style, colour, line) {
-  const lead = DIAGNOSTIC_LEAD.exec(line);
-  if (lead === null) {
-    return style([colour], line);
+// src/launcher/report.ts
+function renderReport(rows, style) {
+  if (rows.length === 0) {
+    return [];
+  }
+  const labelWidth = Math.max(...rows.map((row) => row.label.length));
+  const indent = " ".repeat(COLUMN_GAP.length);
+  const lines = [style(["bold"], REPORT_HEADING)];
+  for (const row of rows) {
+    const detail = row.detail === void 0 ? "" : ` ${style(["dim"], `(${row.detail})`)}`;
+    lines.push(`${indent}${style(["dim"], row.label.padEnd(labelWidth))}${COLUMN_GAP}${row.value}${detail}`);
+    for (const note of row.notes ?? []) {
+      lines.push(`${indent}${" ".repeat(labelWidth)}${COLUMN_GAP}${style(["dim"], note)}`);
+    }
+  }
+  return lines;
+}
+var REPORT_HEADING, COLUMN_GAP;
+var init_report = __esm({
+  "src/launcher/report.ts"() {
+    "use strict";
+    REPORT_HEADING = "agent-shim";
+    COLUMN_GAP = "  ";
   }
-  const [whole, prefix = "", code = "", separator = ""] = lead;
-  return `${style([colour], prefix)}${style([colour, "bold"], code)}${style([colour], `${separator}${line.slice(whole.length)}`)}`;
+});
+
+// src/logStyle.ts
+function styledDiagnostic(style, colour, text2) {
+  return text2.split("\n").map((line, index) => {
+    const lead = index === 0 ? DIAGNOSTIC_LEAD.exec(line) : null;
+    if (lead === null) {
+      return style([colour], line);
+    }
+    const [whole, prefix = "", code = "", separator = ""] = lead;
+    return `${style([colour], prefix)}${style([colour, "bold"], code)}${style([colour], `${separator}${line.slice(whole.length)}`)}`;
+  }).join("\n");
 }
 function createLogPort(sinks, styleFor) {
   return {
     info: (message) => {
       sinks.out(styleFor.out(["dim"], message));
     },
+    report: (rows) => {
+      for (const line of renderReport(rows, styleFor.out)) {
+        sinks.out(line);
+      }
+    },
     warn: (message) => {
       sinks.warn(styledDiagnostic(styleFor.err, "yellow", message));
     },
@@ -28717,6 +28750,7 @@ var init_logStyle = __esm({
   "src/logStyle.ts"() {
     "use strict";
     import_node_util3 = require("node:util");
+    init_report();
     DIAGNOSTIC_LEAD = /^(agent-shim: )([A-Z][A-Z0-9_]*)(: )/;
   }
 });
@@ -32635,11 +32669,15 @@ var init_flatten = __esm({
 });
 
 // src/resolve/decide.ts
-function unclassifiedEntryMessage(names) {
+function unclassifiedEntrySummary(names) {
   const quoted = names.map((name) => `"${name}"`).join(", ");
-  const subject = names.length === 1 ? `${quoted} is not` : `${String(names.length)} entries are not`;
-  const excluded = names.length === 1 ? "it is excluded" : `they are excluded: ${quoted}`;
-  return `${subject} in the category map, so ${excluded}. Run \`agent-shim configure\` to classify ${names.length === 1 ? "it" : "them"}, which records the answer in the local overlay without touching the shipped default map.`;
+  return names.length === 1 ? `${quoted} is not in the category map, so it is excluded` : `${String(names.length)} entries are not in the category map, so they are excluded: ${quoted}`;
+}
+function unclassifiedEntryFix(names) {
+  return `Run \`agent-shim configure\` to classify ${names.length === 1 ? "it" : "them"}`;
+}
+function unclassifiedEntryMessage(names) {
+  return `${unclassifiedEntrySummary(names)}. ${unclassifiedEntryFix(names)}.`;
 }
 function selectRule(relPath, flattened, context) {
   const eliminated = [];
@@ -34280,7 +34318,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.28.0",
+      version: "11.29.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -63595,7 +63633,9 @@ function diagnosticLines(diagnostics) {
     if (diagnostic.code === "UNCLASSIFIED_ENTRY") {
       if (!unclassifiedReported) {
         unclassifiedReported = true;
-        lines.push({ severity: diagnostic.severity, text: `agent-shim: ${diagnostic.code}: ${unclassifiedEntryMessage(unclassified.filter((name) => name !== void 0))}` });
+        const names = unclassified.filter((name) => name !== void 0);
+        lines.push({ severity: diagnostic.severity, text: `agent-shim: ${diagnostic.code}: ${unclassifiedEntrySummary(names)}
+  ${unclassifiedEntryFix(names)}.` });
       }
       continue;
     }
@@ -63603,8 +63643,8 @@ function diagnosticLines(diagnostics) {
   }
   return lines;
 }
-function reportDiagnostics(log, diagnostics, options) {
-  for (const line of diagnosticLines(diagnostics)) {
+function printDiagnosticLines(log, lines, options) {
+  for (const line of lines) {
     if (line.severity === "error" && !options.errorsAsWarnings) {
       log.error(line.text);
     } else {
@@ -63612,6 +63652,9 @@ function reportDiagnostics(log, diagnostics, options) {
     }
   }
 }
+function reportDiagnostics(log, diagnostics, options) {
+  printDiagnosticLines(log, diagnosticLines(diagnostics), options);
+}
 var init_diagnostics = __esm({
   "src/launcher/diagnostics.ts"() {
     "use strict";
@@ -63644,6 +63687,59 @@ var init_hold = __esm({
   }
 });
 
+// src/launcher/launchReport.ts
+function poolDetail(pool) {
+  const [reason] = pool.reasons;
+  if (pool.movedOff !== void 0) {
+    return { detail: `moved off ${pool.movedOff.identity}: ${pool.movedOff.reason}`, ...reason === void 0 ? {} : { notes: [reason] } };
+  }
+  return reason === void 0 ? {} : { detail: reason };
+}
+function decisionRows(facts) {
+  return [
+    { label: "identity", value: facts.identity ?? "(none)", detail: facts.identitySource },
+    ...facts.pool === void 0 ? [] : [
+      {
+        label: "pool",
+        value: facts.pool.name,
+        ...poolDetail(facts.pool)
+      }
+    ],
+    ...facts.profile === void 0 ? [] : [{ label: "profile", value: facts.profile.name, detail: facts.profile.source }],
+    ...facts.provider === void 0 ? [] : [{ label: "provider", value: facts.provider.name, detail: `credential ${facts.provider.credential}` }],
+    ...facts.identityCredential === void 0 ? [] : [{ label: "credential", value: facts.identityCredential, detail: "the identity's own" }]
+  ];
+}
+function pinnedVersionRow(version2, source) {
+  return { label: "claude", value: version2, detail: `pinned by ${source}` };
+}
+function routingRows(facts) {
+  if (facts.frontDoor === void 0) {
+    return [];
+  }
+  return [
+    {
+      label: "routing",
+      value: `front door 127.0.0.1:${String(facts.frontDoor.port)}`,
+      ...facts.provider ? {} : { detail: `OAuth via CONNECT 127.0.0.1:${String(facts.frontDoor.connectPort)}` }
+    },
+    ...facts.headroom === void 0 ? [] : [{ label: "headroom", value: "on", detail: `project ${facts.headroom.projectId}` }]
+  ];
+}
+function farmRow(links, builtDirectories, adopted) {
+  const counted = (count, singular, plural2) => `${String(count)} ${count === 1 ? singular : plural2}`;
+  const parts = [counted(links, "link", "links"), counted(builtDirectories, "built directory", "built directories"), ...adopted === 0 ? [] : [`${String(adopted)} adopted`]];
+  return { label: "farm", value: "resynced", detail: parts.join(", ") };
+}
+function noteRow(text2) {
+  return { label: "note", value: text2 };
+}
+var init_launchReport = __esm({
+  "src/launcher/launchReport.ts"() {
+    "use strict";
+  }
+});
+
 // src/antigravity/cloudUpstream.ts
 function isCcpaEndpoint(endpoint) {
   return endpoint.includes("cloudcode-pa.googleapis.com");
@@ -65038,7 +65134,7 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   if (params.supervised?.member !== void 0) {
     const reasons = ["resumed here by the supervising launcher after the previous member ran out of quota"];
-    return { identityDecision: { ...decided, name: params.supervised.member }, poolExplanation: `pool ${decided.pool}: ${reasons.join("; ")}`, poolPick: { name: decided.pool, reasons } };
+    return { identityDecision: { ...decided, name: params.supervised.member }, poolPick: { name: decided.pool, reasons } };
   }
   const farmRuntime = params.farm;
   if (farmRuntime === void 0) {
@@ -65069,7 +65165,6 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   return {
     identityDecision: { ...decided, name: resolution.identity },
-    poolExplanation: resolution.explanation,
     poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } }
   };
 }
@@ -65097,7 +65192,7 @@ function decideLaunch(params, readOnly) {
       return trimmed === "" ? void 0 : trimmed;
     }
   });
-  const { identityDecision, poolExplanation, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
+  const { identityDecision, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
   const farmIdentity = configDirEscapeHatchApplies ? void 0 : identityDecision.name;
   const farm = farmIdentity === void 0 ? void 0 : params.farm;
   if (!readOnly && farm !== void 0 && farmIdentity !== void 0) {
@@ -65237,15 +65332,16 @@ function decideLaunch(params, readOnly) {
     }
   });
   const loginlessProvider = requestedFlags.remoteControl && selectedProvider !== void 0 && farmIdentity !== void 0 && params.hasStoredLogin?.(farmIdentity) === false ? { identity: farmIdentity, provider: selectedProvider.name } : void 0;
-  if (loginlessProvider !== void 0 && !readOnly) {
-    log.info(`agent-shim: identity ${loginlessProvider.identity} has no stored login, so Remote Control, which needs one, is off for this launch; provider ${loginlessProvider.provider} runs without it`);
+  const notes = [];
+  if (loginlessProvider !== void 0) {
+    notes.push(`${loginlessProvider.identity} has no stored login, so Remote Control is off; provider ${loginlessProvider.provider} runs without it`);
   }
   const flags = loginlessProvider === void 0 ? requestedFlags : { ...requestedFlags, remoteControl: false };
   const catalogue = selectedProvider === void 0 ? void 0 : parseCatalogueCache(params.fs.readFileUtf8(catalogueCachePath(paths, selectedProvider.name)));
   const pickerSettings = selectedProvider === void 0 ? void 0 : modelPickerSettings(selectedProvider.definition, catalogue?.models);
   const callerSettings = hasSettingsArgument(parsedArgv.rest);
-  if (pickerSettings !== void 0 && callerSettings && !readOnly) {
-    log.info("agent-shim: this launch passes its own --settings, so /model keeps Claude Code's own model names instead of listing the provider's models");
+  if (pickerSettings !== void 0 && callerSettings) {
+    notes.push("--settings was passed, so /model keeps Claude Code's own model names");
   }
   const launcherSettings = mergeSettings([params.supervised?.settings, callerSettings ? void 0 : pickerSettings]);
   const args = buildArgv({
@@ -65267,8 +65363,8 @@ function decideLaunch(params, readOnly) {
   return {
     parsedArgv,
     identityDecision,
-    poolExplanation,
     poolPick,
+    notes,
     configDirEscapeHatch: configDirEscapeHatchApplies,
     farmIdentity,
     farmContext,
@@ -65288,10 +65384,18 @@ function prepareLaunch(params) {
   const { paths, proc, log } = params;
   const { env } = proc;
   const decided = decideLaunch(params, false);
-  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolExplanation, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
-  log.info(
-    `agent-shim: identity ${identityDecision.name ?? "(none)"} (${identityDecision.source}${poolExplanation === void 0 ? "" : `, ${poolExplanation}`}), config profile ${configProfileDecision.name ?? "(none)"} (${configProfileDecision.source})` + (resolvedProvider === void 0 ? "" : `, provider ${resolvedProvider.name} (credential ${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)})`) + (identityCredential === void 0 ? "" : `, identity credential ${identityCredential.target} from ${describeSource(identityCredential.source)}`)
-  );
+  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
+  const rows = [
+    ...decisionRows({
+      identity: identityDecision.name,
+      identitySource: identityDecision.source,
+      pool: poolPick,
+      profile: configProfileDecision.name === void 0 ? void 0 : { name: configProfileDecision.name, source: configProfileDecision.source },
+      provider: resolvedProvider === void 0 ? void 0 : { name: resolvedProvider.name, credential: `${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)}` },
+      identityCredential: identityCredential === void 0 ? void 0 : `${identityCredential.target} from ${describeSource(identityCredential.source)}`
+    })
+  ];
+  let warnings = [];
   const updateCheck = runLaunchUpdateCheck({
     mode: params.updateMode ?? "off",
     checkPath: import_node_path43.default.join(paths.root, "update.check"),
@@ -65326,15 +65430,13 @@ function prepareLaunch(params) {
       }
       throw error63;
     }
-    reportDiagnostics(log, result.diagnostics, { errorsAsWarnings: false });
+    warnings = diagnosticLines(result.diagnostics);
     if (!result.noOp) {
-      log.info(
-        `agent-shim: farm at ${result.farmRoot} resynced (${String(result.manifest.links.length)} link(s), ${String(result.manifest.materialised.length)} built director(ies)${result.adopted.length === 0 ? "" : `, ${String(result.adopted.length)} adopted into ${resyncFarmRuntime.claudeHome}`})`
-      );
+      rows.push(farmRow(result.manifest.links.length, result.manifest.materialised.length, result.adopted.length));
     }
   }
   if (decided.pinnedVersion !== void 0) {
-    log.info(`agent-shim: Claude Code ${decided.pinnedVersion.version} (pinned by ${decided.pinnedVersion.source})`);
+    rows.push(pinnedVersionRow(decided.pinnedVersion.version, decided.pinnedVersion.source));
   }
   const frontDoorPort = params.frontdoor;
   const frontDoorEngaged = resolvedProvider !== void 0 || resolvedFlags.headroom || resolvedFlags.trackUsage;
@@ -65350,14 +65452,11 @@ function prepareLaunch(params) {
   const headroomPort = params.headroom;
   if (resolvedFlags.headroom && headroomPort !== void 0) {
     headroom = headroomPort.ensure({ routesProvider: resolvedProvider !== void 0 });
-    const via = resolvedProvider === void 0 ? `OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor?.connectPort ?? 0)}` : `provider ${resolvedProvider.name}`;
-    log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor?.port ?? 0)} with headroom on unix socket ${headroom.socketPath} (${via}, project ${headroom.projectId})`);
   } else if (resolvedFlags.headroom) {
     log.error("agent-shim: headroom routing was requested but this launcher has no headroom port wired; refusing to launch without it.");
     proc.exit(1);
-  } else if (frontDoor !== void 0) {
-    log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor.port)}${resolvedProvider === void 0 ? ` (OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor.connectPort)}, usage recorded)` : ` (provider ${resolvedProvider.name})`}`);
   }
+  rows.push(...routingRows({ frontDoor, headroom, provider: resolvedProvider !== void 0 }));
   const frontDoorRelease = frontDoor === void 0 ? void 0 : frontDoorPort?.release;
   const sessionId = params.supervised?.sessionId ?? (0, import_node_crypto18.randomUUID)();
   const finalEnv = buildEnv({
@@ -65378,6 +65477,9 @@ function prepareLaunch(params) {
       registered();
     }
   };
+  rows.push(...notes.map(noteRow));
+  log.report(rows);
+  printDiagnosticLines(log, warnings, { errorsAsWarnings: false });
   const hold = () => holdBeforeLaunch({ delayMs: resolvedFlags.delayMs, pause: resolvedFlags.pause }, params.hold, log);
   return { bin: decided.bin, args: finalArgv, env: finalEnv, sessionId, release, markChildStarted: updateCheck.markChildStarted, hold, decision };
 }
@@ -65446,6 +65548,7 @@ var init_launcher = __esm({
     init_claudeSession();
     init_diagnostics();
     init_hold();
+    init_launchReport();
     init_modelPicker();
     init_providerCatalogue();
     init_pool();
@@ -65537,6 +65640,7 @@ function resolveClaudeLaunch(options) {
   const warnings = [];
   const log = {
     info: () => void 0,
+    report: () => void 0,
     warn: (message) => {
       warnings.push(message);
     },
@@ -65607,6 +65711,7 @@ async function withIdentityClaude(params, identity, flags, use2) {
       },
       log: {
         info: () => void 0,
+        report: () => void 0,
         warn: () => void 0,
         error: (message) => {
           refusals.push(message);

package/dist/index.cjs

@@ -1496,11 +1496,15 @@ var init_flatten = __esm({
 });
 
 // src/resolve/decide.ts
-function unclassifiedEntryMessage(names) {
+function unclassifiedEntrySummary(names) {
   const quoted = names.map((name) => `"${name}"`).join(", ");
-  const subject = names.length === 1 ? `${quoted} is not` : `${String(names.length)} entries are not`;
-  const excluded = names.length === 1 ? "it is excluded" : `they are excluded: ${quoted}`;
-  return `${subject} in the category map, so ${excluded}. Run \`agent-shim configure\` to classify ${names.length === 1 ? "it" : "them"}, which records the answer in the local overlay without touching the shipped default map.`;
+  return names.length === 1 ? `${quoted} is not in the category map, so it is excluded` : `${String(names.length)} entries are not in the category map, so they are excluded: ${quoted}`;
+}
+function unclassifiedEntryFix(names) {
+  return `Run \`agent-shim configure\` to classify ${names.length === 1 ? "it" : "them"}`;
+}
+function unclassifiedEntryMessage(names) {
+  return `${unclassifiedEntrySummary(names)}. ${unclassifiedEntryFix(names)}.`;
 }
 function selectRule(relPath, flattened, context) {
   const eliminated = [];
@@ -2974,7 +2978,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.28.0",
+      version: "11.29.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -4140,20 +4144,53 @@ var init_supervisor = __esm({
   }
 });
 
-// src/logStyle.ts
-function styledDiagnostic(style, colour, line) {
-  const lead = DIAGNOSTIC_LEAD.exec(line);
-  if (lead === null) {
-    return style([colour], line);
+// src/launcher/report.ts
+function renderReport(rows, style) {
+  if (rows.length === 0) {
+    return [];
+  }
+  const labelWidth = Math.max(...rows.map((row) => row.label.length));
+  const indent = " ".repeat(COLUMN_GAP.length);
+  const lines = [style(["bold"], REPORT_HEADING)];
+  for (const row of rows) {
+    const detail = row.detail === void 0 ? "" : ` ${style(["dim"], `(${row.detail})`)}`;
+    lines.push(`${indent}${style(["dim"], row.label.padEnd(labelWidth))}${COLUMN_GAP}${row.value}${detail}`);
+    for (const note of row.notes ?? []) {
+      lines.push(`${indent}${" ".repeat(labelWidth)}${COLUMN_GAP}${style(["dim"], note)}`);
+    }
+  }
+  return lines;
+}
+var REPORT_HEADING, COLUMN_GAP;
+var init_report = __esm({
+  "src/launcher/report.ts"() {
+    "use strict";
+    REPORT_HEADING = "agent-shim";
+    COLUMN_GAP = "  ";
   }
-  const [whole, prefix = "", code = "", separator = ""] = lead;
-  return `${style([colour], prefix)}${style([colour, "bold"], code)}${style([colour], `${separator}${line.slice(whole.length)}`)}`;
+});
+
+// src/logStyle.ts
+function styledDiagnostic(style, colour, text) {
+  return text.split("\n").map((line, index) => {
+    const lead = index === 0 ? DIAGNOSTIC_LEAD.exec(line) : null;
+    if (lead === null) {
+      return style([colour], line);
+    }
+    const [whole, prefix = "", code = "", separator = ""] = lead;
+    return `${style([colour], prefix)}${style([colour, "bold"], code)}${style([colour], `${separator}${line.slice(whole.length)}`)}`;
+  }).join("\n");
 }
 function createLogPort(sinks, styleFor) {
   return {
     info: (message) => {
       sinks.out(styleFor.out(["dim"], message));
     },
+    report: (rows) => {
+      for (const line of renderReport(rows, styleFor.out)) {
+        sinks.out(line);
+      }
+    },
     warn: (message) => {
       sinks.warn(styledDiagnostic(styleFor.err, "yellow", message));
     },
@@ -4170,6 +4207,7 @@ var init_logStyle = __esm({
   "src/logStyle.ts"() {
     "use strict";
     import_node_util = require("node:util");
+    init_report();
     DIAGNOSTIC_LEAD = /^(agent-shim: )([A-Z][A-Z0-9_]*)(: )/;
   }
 });
@@ -8014,7 +8052,9 @@ function diagnosticLines(diagnostics) {
     if (diagnostic.code === "UNCLASSIFIED_ENTRY") {
       if (!unclassifiedReported) {
         unclassifiedReported = true;
-        lines.push({ severity: diagnostic.severity, text: `agent-shim: ${diagnostic.code}: ${unclassifiedEntryMessage(unclassified.filter((name) => name !== void 0))}` });
+        const names = unclassified.filter((name) => name !== void 0);
+        lines.push({ severity: diagnostic.severity, text: `agent-shim: ${diagnostic.code}: ${unclassifiedEntrySummary(names)}
+  ${unclassifiedEntryFix(names)}.` });
       }
       continue;
     }
@@ -8022,8 +8062,8 @@ function diagnosticLines(diagnostics) {
   }
   return lines;
 }
-function reportDiagnostics(log, diagnostics, options) {
-  for (const line of diagnosticLines(diagnostics)) {
+function printDiagnosticLines(log, lines, options) {
+  for (const line of lines) {
     if (line.severity === "error" && !options.errorsAsWarnings) {
       log.error(line.text);
     } else {
@@ -8031,6 +8071,9 @@ function reportDiagnostics(log, diagnostics, options) {
     }
   }
 }
+function reportDiagnostics(log, diagnostics, options) {
+  printDiagnosticLines(log, diagnosticLines(diagnostics), options);
+}
 var init_diagnostics = __esm({
   "src/launcher/diagnostics.ts"() {
     "use strict";
@@ -8063,6 +8106,59 @@ var init_hold = __esm({
   }
 });
 
+// src/launcher/launchReport.ts
+function poolDetail(pool) {
+  const [reason] = pool.reasons;
+  if (pool.movedOff !== void 0) {
+    return { detail: `moved off ${pool.movedOff.identity}: ${pool.movedOff.reason}`, ...reason === void 0 ? {} : { notes: [reason] } };
+  }
+  return reason === void 0 ? {} : { detail: reason };
+}
+function decisionRows(facts) {
+  return [
+    { label: "identity", value: facts.identity ?? "(none)", detail: facts.identitySource },
+    ...facts.pool === void 0 ? [] : [
+      {
+        label: "pool",
+        value: facts.pool.name,
+        ...poolDetail(facts.pool)
+      }
+    ],
+    ...facts.profile === void 0 ? [] : [{ label: "profile", value: facts.profile.name, detail: facts.profile.source }],
+    ...facts.provider === void 0 ? [] : [{ label: "provider", value: facts.provider.name, detail: `credential ${facts.provider.credential}` }],
+    ...facts.identityCredential === void 0 ? [] : [{ label: "credential", value: facts.identityCredential, detail: "the identity's own" }]
+  ];
+}
+function pinnedVersionRow(version, source) {
+  return { label: "claude", value: version, detail: `pinned by ${source}` };
+}
+function routingRows(facts) {
+  if (facts.frontDoor === void 0) {
+    return [];
+  }
+  return [
+    {
+      label: "routing",
+      value: `front door 127.0.0.1:${String(facts.frontDoor.port)}`,
+      ...facts.provider ? {} : { detail: `OAuth via CONNECT 127.0.0.1:${String(facts.frontDoor.connectPort)}` }
+    },
+    ...facts.headroom === void 0 ? [] : [{ label: "headroom", value: "on", detail: `project ${facts.headroom.projectId}` }]
+  ];
+}
+function farmRow(links, builtDirectories, adopted) {
+  const counted = (count, singular, plural) => `${String(count)} ${count === 1 ? singular : plural}`;
+  const parts = [counted(links, "link", "links"), counted(builtDirectories, "built directory", "built directories"), ...adopted === 0 ? [] : [`${String(adopted)} adopted`]];
+  return { label: "farm", value: "resynced", detail: parts.join(", ") };
+}
+function noteRow(text) {
+  return { label: "note", value: text };
+}
+var init_launchReport = __esm({
+  "src/launcher/launchReport.ts"() {
+    "use strict";
+  }
+});
+
 // src/antigravity/cloudUpstream.ts
 var init_cloudUpstream = __esm({
   "src/antigravity/cloudUpstream.ts"() {
@@ -8588,7 +8684,7 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   if (params.supervised?.member !== void 0) {
     const reasons = ["resumed here by the supervising launcher after the previous member ran out of quota"];
-    return { identityDecision: { ...decided, name: params.supervised.member }, poolExplanation: `pool ${decided.pool}: ${reasons.join("; ")}`, poolPick: { name: decided.pool, reasons } };
+    return { identityDecision: { ...decided, name: params.supervised.member }, poolPick: { name: decided.pool, reasons } };
   }
   const farmRuntime = params.farm;
   if (farmRuntime === void 0) {
@@ -8619,7 +8715,6 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   return {
     identityDecision: { ...decided, name: resolution.identity },
-    poolExplanation: resolution.explanation,
     poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } }
   };
 }
@@ -8647,7 +8742,7 @@ function decideLaunch(params, readOnly) {
       return trimmed === "" ? void 0 : trimmed;
     }
   });
-  const { identityDecision, poolExplanation, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
+  const { identityDecision, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
   const farmIdentity = configDirEscapeHatchApplies ? void 0 : identityDecision.name;
   const farm = farmIdentity === void 0 ? void 0 : params.farm;
   if (!readOnly && farm !== void 0 && farmIdentity !== void 0) {
@@ -8787,15 +8882,16 @@ function decideLaunch(params, readOnly) {
     }
   });
   const loginlessProvider = requestedFlags.remoteControl && selectedProvider !== void 0 && farmIdentity !== void 0 && params.hasStoredLogin?.(farmIdentity) === false ? { identity: farmIdentity, provider: selectedProvider.name } : void 0;
-  if (loginlessProvider !== void 0 && !readOnly) {
-    log.info(`agent-shim: identity ${loginlessProvider.identity} has no stored login, so Remote Control, which needs one, is off for this launch; provider ${loginlessProvider.provider} runs without it`);
+  const notes = [];
+  if (loginlessProvider !== void 0) {
+    notes.push(`${loginlessProvider.identity} has no stored login, so Remote Control is off; provider ${loginlessProvider.provider} runs without it`);
   }
   const flags = loginlessProvider === void 0 ? requestedFlags : { ...requestedFlags, remoteControl: false };
   const catalogue = selectedProvider === void 0 ? void 0 : parseCatalogueCache(params.fs.readFileUtf8(catalogueCachePath(paths, selectedProvider.name)));
   const pickerSettings = selectedProvider === void 0 ? void 0 : modelPickerSettings(selectedProvider.definition, catalogue?.models);
   const callerSettings = hasSettingsArgument(parsedArgv.rest);
-  if (pickerSettings !== void 0 && callerSettings && !readOnly) {
-    log.info("agent-shim: this launch passes its own --settings, so /model keeps Claude Code's own model names instead of listing the provider's models");
+  if (pickerSettings !== void 0 && callerSettings) {
+    notes.push("--settings was passed, so /model keeps Claude Code's own model names");
   }
   const launcherSettings = mergeSettings([params.supervised?.settings, callerSettings ? void 0 : pickerSettings]);
   const args = buildArgv({
@@ -8817,8 +8913,8 @@ function decideLaunch(params, readOnly) {
   return {
     parsedArgv,
     identityDecision,
-    poolExplanation,
     poolPick,
+    notes,
     configDirEscapeHatch: configDirEscapeHatchApplies,
     farmIdentity,
     farmContext,
@@ -8838,10 +8934,18 @@ function prepareLaunch(params) {
   const { paths, proc, log } = params;
   const { env } = proc;
   const decided = decideLaunch(params, false);
-  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolExplanation, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
-  log.info(
-    `agent-shim: identity ${identityDecision.name ?? "(none)"} (${identityDecision.source}${poolExplanation === void 0 ? "" : `, ${poolExplanation}`}), config profile ${configProfileDecision.name ?? "(none)"} (${configProfileDecision.source})` + (resolvedProvider === void 0 ? "" : `, provider ${resolvedProvider.name} (credential ${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)})`) + (identityCredential === void 0 ? "" : `, identity credential ${identityCredential.target} from ${describeSource(identityCredential.source)}`)
-  );
+  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
+  const rows = [
+    ...decisionRows({
+      identity: identityDecision.name,
+      identitySource: identityDecision.source,
+      pool: poolPick,
+      profile: configProfileDecision.name === void 0 ? void 0 : { name: configProfileDecision.name, source: configProfileDecision.source },
+      provider: resolvedProvider === void 0 ? void 0 : { name: resolvedProvider.name, credential: `${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)}` },
+      identityCredential: identityCredential === void 0 ? void 0 : `${identityCredential.target} from ${describeSource(identityCredential.source)}`
+    })
+  ];
+  let warnings = [];
   const updateCheck = runLaunchUpdateCheck({
     mode: params.updateMode ?? "off",
     checkPath: import_node_path39.default.join(paths.root, "update.check"),
@@ -8876,15 +8980,13 @@ function prepareLaunch(params) {
       }
       throw error;
     }
-    reportDiagnostics(log, result.diagnostics, { errorsAsWarnings: false });
+    warnings = diagnosticLines(result.diagnostics);
     if (!result.noOp) {
-      log.info(
-        `agent-shim: farm at ${result.farmRoot} resynced (${String(result.manifest.links.length)} link(s), ${String(result.manifest.materialised.length)} built director(ies)${result.adopted.length === 0 ? "" : `, ${String(result.adopted.length)} adopted into ${resyncFarmRuntime.claudeHome}`})`
-      );
+      rows.push(farmRow(result.manifest.links.length, result.manifest.materialised.length, result.adopted.length));
     }
   }
   if (decided.pinnedVersion !== void 0) {
-    log.info(`agent-shim: Claude Code ${decided.pinnedVersion.version} (pinned by ${decided.pinnedVersion.source})`);
+    rows.push(pinnedVersionRow(decided.pinnedVersion.version, decided.pinnedVersion.source));
   }
   const frontDoorPort = params.frontdoor;
   const frontDoorEngaged = resolvedProvider !== void 0 || resolvedFlags.headroom || resolvedFlags.trackUsage;
@@ -8900,14 +9002,11 @@ function prepareLaunch(params) {
   const headroomPort = params.headroom;
   if (resolvedFlags.headroom && headroomPort !== void 0) {
     headroom = headroomPort.ensure({ routesProvider: resolvedProvider !== void 0 });
-    const via = resolvedProvider === void 0 ? `OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor?.connectPort ?? 0)}` : `provider ${resolvedProvider.name}`;
-    log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor?.port ?? 0)} with headroom on unix socket ${headroom.socketPath} (${via}, project ${headroom.projectId})`);
   } else if (resolvedFlags.headroom) {
     log.error("agent-shim: headroom routing was requested but this launcher has no headroom port wired; refusing to launch without it.");
     proc.exit(1);
-  } else if (frontDoor !== void 0) {
-    log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor.port)}${resolvedProvider === void 0 ? ` (OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor.connectPort)}, usage recorded)` : ` (provider ${resolvedProvider.name})`}`);
   }
+  rows.push(...routingRows({ frontDoor, headroom, provider: resolvedProvider !== void 0 }));
   const frontDoorRelease = frontDoor === void 0 ? void 0 : frontDoorPort?.release;
   const sessionId = params.supervised?.sessionId ?? (0, import_node_crypto11.randomUUID)();
   const finalEnv = buildEnv({
@@ -8928,6 +9027,9 @@ function prepareLaunch(params) {
       registered();
     }
   };
+  rows.push(...notes.map(noteRow));
+  log.report(rows);
+  printDiagnosticLines(log, warnings, { errorsAsWarnings: false });
   const hold = () => holdBeforeLaunch({ delayMs: resolvedFlags.delayMs, pause: resolvedFlags.pause }, params.hold, log);
   return { bin: decided.bin, args: finalArgv, env: finalEnv, sessionId, release, markChildStarted: updateCheck.markChildStarted, hold, decision };
 }
@@ -8996,6 +9098,7 @@ var init_launcher = __esm({
     init_claudeSession();
     init_diagnostics();
     init_hold();
+    init_launchReport();
     init_modelPicker();
     init_providerCatalogue();
     init_pool();
@@ -9219,6 +9322,7 @@ function prepareClaudeLaunch(options) {
   const refusals = [];
   const log = {
     info: () => void 0,
+    report: () => void 0,
     warn: () => void 0,
     error: (message) => {
       refusals.push(message);
@@ -9240,6 +9344,7 @@ function resolveClaudeLaunch(options) {
   const warnings = [];
   const log = {
     info: () => void 0,
+    report: () => void 0,
     warn: (message) => {
       warnings.push(message);
     },
@@ -9448,6 +9553,7 @@ async function withIdentityClaude(params, identity, flags, use) {
       },
       log: {
         info: () => void 0,
+        report: () => void 0,
         warn: () => void 0,
         error: (message) => {
           refusals.push(message);

package/dist/index.mjs

@@ -1474,11 +1474,15 @@ var init_flatten = __esm({
 });
 
 // src/resolve/decide.ts
-function unclassifiedEntryMessage(names) {
+function unclassifiedEntrySummary(names) {
   const quoted = names.map((name) => `"${name}"`).join(", ");
-  const subject = names.length === 1 ? `${quoted} is not` : `${String(names.length)} entries are not`;
-  const excluded = names.length === 1 ? "it is excluded" : `they are excluded: ${quoted}`;
-  return `${subject} in the category map, so ${excluded}. Run \`agent-shim configure\` to classify ${names.length === 1 ? "it" : "them"}, which records the answer in the local overlay without touching the shipped default map.`;
+  return names.length === 1 ? `${quoted} is not in the category map, so it is excluded` : `${String(names.length)} entries are not in the category map, so they are excluded: ${quoted}`;
+}
+function unclassifiedEntryFix(names) {
+  return `Run \`agent-shim configure\` to classify ${names.length === 1 ? "it" : "them"}`;
+}
+function unclassifiedEntryMessage(names) {
+  return `${unclassifiedEntrySummary(names)}. ${unclassifiedEntryFix(names)}.`;
 }
 function selectRule(relPath, flattened, context) {
   const eliminated = [];
@@ -2950,7 +2954,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.28.0",
+      version: "11.29.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -4115,21 +4119,54 @@ var init_supervisor = __esm({
   }
 });
 
+// src/launcher/report.ts
+function renderReport(rows, style) {
+  if (rows.length === 0) {
+    return [];
+  }
+  const labelWidth = Math.max(...rows.map((row) => row.label.length));
+  const indent = " ".repeat(COLUMN_GAP.length);
+  const lines = [style(["bold"], REPORT_HEADING)];
+  for (const row of rows) {
+    const detail = row.detail === void 0 ? "" : ` ${style(["dim"], `(${row.detail})`)}`;
+    lines.push(`${indent}${style(["dim"], row.label.padEnd(labelWidth))}${COLUMN_GAP}${row.value}${detail}`);
+    for (const note of row.notes ?? []) {
+      lines.push(`${indent}${" ".repeat(labelWidth)}${COLUMN_GAP}${style(["dim"], note)}`);
+    }
+  }
+  return lines;
+}
+var REPORT_HEADING, COLUMN_GAP;
+var init_report = __esm({
+  "src/launcher/report.ts"() {
+    "use strict";
+    REPORT_HEADING = "agent-shim";
+    COLUMN_GAP = "  ";
+  }
+});
+
 // src/logStyle.ts
 import { styleText } from "node:util";
-function styledDiagnostic(style, colour, line) {
-  const lead = DIAGNOSTIC_LEAD.exec(line);
-  if (lead === null) {
-    return style([colour], line);
-  }
-  const [whole, prefix = "", code = "", separator = ""] = lead;
-  return `${style([colour], prefix)}${style([colour, "bold"], code)}${style([colour], `${separator}${line.slice(whole.length)}`)}`;
+function styledDiagnostic(style, colour, text) {
+  return text.split("\n").map((line, index) => {
+    const lead = index === 0 ? DIAGNOSTIC_LEAD.exec(line) : null;
+    if (lead === null) {
+      return style([colour], line);
+    }
+    const [whole, prefix = "", code = "", separator = ""] = lead;
+    return `${style([colour], prefix)}${style([colour, "bold"], code)}${style([colour], `${separator}${line.slice(whole.length)}`)}`;
+  }).join("\n");
 }
 function createLogPort(sinks, styleFor) {
   return {
     info: (message) => {
       sinks.out(styleFor.out(["dim"], message));
     },
+    report: (rows) => {
+      for (const line of renderReport(rows, styleFor.out)) {
+        sinks.out(line);
+      }
+    },
     warn: (message) => {
       sinks.warn(styledDiagnostic(styleFor.err, "yellow", message));
     },
@@ -4145,6 +4182,7 @@ var DIAGNOSTIC_LEAD;
 var init_logStyle = __esm({
   "src/logStyle.ts"() {
     "use strict";
+    init_report();
     DIAGNOSTIC_LEAD = /^(agent-shim: )([A-Z][A-Z0-9_]*)(: )/;
   }
 });
@@ -7986,7 +8024,9 @@ function diagnosticLines(diagnostics) {
     if (diagnostic.code === "UNCLASSIFIED_ENTRY") {
       if (!unclassifiedReported) {
         unclassifiedReported = true;
-        lines.push({ severity: diagnostic.severity, text: `agent-shim: ${diagnostic.code}: ${unclassifiedEntryMessage(unclassified.filter((name) => name !== void 0))}` });
+        const names = unclassified.filter((name) => name !== void 0);
+        lines.push({ severity: diagnostic.severity, text: `agent-shim: ${diagnostic.code}: ${unclassifiedEntrySummary(names)}
+  ${unclassifiedEntryFix(names)}.` });
       }
       continue;
     }
@@ -7994,8 +8034,8 @@ function diagnosticLines(diagnostics) {
   }
   return lines;
 }
-function reportDiagnostics(log, diagnostics, options) {
-  for (const line of diagnosticLines(diagnostics)) {
+function printDiagnosticLines(log, lines, options) {
+  for (const line of lines) {
     if (line.severity === "error" && !options.errorsAsWarnings) {
       log.error(line.text);
     } else {
@@ -8003,6 +8043,9 @@ function reportDiagnostics(log, diagnostics, options) {
     }
   }
 }
+function reportDiagnostics(log, diagnostics, options) {
+  printDiagnosticLines(log, diagnosticLines(diagnostics), options);
+}
 var init_diagnostics = __esm({
   "src/launcher/diagnostics.ts"() {
     "use strict";
@@ -8035,6 +8078,59 @@ var init_hold = __esm({
   }
 });
 
+// src/launcher/launchReport.ts
+function poolDetail(pool) {
+  const [reason] = pool.reasons;
+  if (pool.movedOff !== void 0) {
+    return { detail: `moved off ${pool.movedOff.identity}: ${pool.movedOff.reason}`, ...reason === void 0 ? {} : { notes: [reason] } };
+  }
+  return reason === void 0 ? {} : { detail: reason };
+}
+function decisionRows(facts) {
+  return [
+    { label: "identity", value: facts.identity ?? "(none)", detail: facts.identitySource },
+    ...facts.pool === void 0 ? [] : [
+      {
+        label: "pool",
+        value: facts.pool.name,
+        ...poolDetail(facts.pool)
+      }
+    ],
+    ...facts.profile === void 0 ? [] : [{ label: "profile", value: facts.profile.name, detail: facts.profile.source }],
+    ...facts.provider === void 0 ? [] : [{ label: "provider", value: facts.provider.name, detail: `credential ${facts.provider.credential}` }],
+    ...facts.identityCredential === void 0 ? [] : [{ label: "credential", value: facts.identityCredential, detail: "the identity's own" }]
+  ];
+}
+function pinnedVersionRow(version, source) {
+  return { label: "claude", value: version, detail: `pinned by ${source}` };
+}
+function routingRows(facts) {
+  if (facts.frontDoor === void 0) {
+    return [];
+  }
+  return [
+    {
+      label: "routing",
+      value: `front door 127.0.0.1:${String(facts.frontDoor.port)}`,
+      ...facts.provider ? {} : { detail: `OAuth via CONNECT 127.0.0.1:${String(facts.frontDoor.connectPort)}` }
+    },
+    ...facts.headroom === void 0 ? [] : [{ label: "headroom", value: "on", detail: `project ${facts.headroom.projectId}` }]
+  ];
+}
+function farmRow(links, builtDirectories, adopted) {
+  const counted = (count, singular, plural) => `${String(count)} ${count === 1 ? singular : plural}`;
+  const parts = [counted(links, "link", "links"), counted(builtDirectories, "built directory", "built directories"), ...adopted === 0 ? [] : [`${String(adopted)} adopted`]];
+  return { label: "farm", value: "resynced", detail: parts.join(", ") };
+}
+function noteRow(text) {
+  return { label: "note", value: text };
+}
+var init_launchReport = __esm({
+  "src/launcher/launchReport.ts"() {
+    "use strict";
+  }
+});
+
 // src/antigravity/cloudUpstream.ts
 var init_cloudUpstream = __esm({
   "src/antigravity/cloudUpstream.ts"() {
@@ -8562,7 +8658,7 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   if (params.supervised?.member !== void 0) {
     const reasons = ["resumed here by the supervising launcher after the previous member ran out of quota"];
-    return { identityDecision: { ...decided, name: params.supervised.member }, poolExplanation: `pool ${decided.pool}: ${reasons.join("; ")}`, poolPick: { name: decided.pool, reasons } };
+    return { identityDecision: { ...decided, name: params.supervised.member }, poolPick: { name: decided.pool, reasons } };
   }
   const farmRuntime = params.farm;
   if (farmRuntime === void 0) {
@@ -8593,7 +8689,6 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   return {
     identityDecision: { ...decided, name: resolution.identity },
-    poolExplanation: resolution.explanation,
     poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } }
   };
 }
@@ -8621,7 +8716,7 @@ function decideLaunch(params, readOnly) {
       return trimmed === "" ? void 0 : trimmed;
     }
   });
-  const { identityDecision, poolExplanation, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
+  const { identityDecision, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
   const farmIdentity = configDirEscapeHatchApplies ? void 0 : identityDecision.name;
   const farm = farmIdentity === void 0 ? void 0 : params.farm;
   if (!readOnly && farm !== void 0 && farmIdentity !== void 0) {
@@ -8761,15 +8856,16 @@ function decideLaunch(params, readOnly) {
     }
   });
   const loginlessProvider = requestedFlags.remoteControl && selectedProvider !== void 0 && farmIdentity !== void 0 && params.hasStoredLogin?.(farmIdentity) === false ? { identity: farmIdentity, provider: selectedProvider.name } : void 0;
-  if (loginlessProvider !== void 0 && !readOnly) {
-    log.info(`agent-shim: identity ${loginlessProvider.identity} has no stored login, so Remote Control, which needs one, is off for this launch; provider ${loginlessProvider.provider} runs without it`);
+  const notes = [];
+  if (loginlessProvider !== void 0) {
+    notes.push(`${loginlessProvider.identity} has no stored login, so Remote Control is off; provider ${loginlessProvider.provider} runs without it`);
   }
   const flags = loginlessProvider === void 0 ? requestedFlags : { ...requestedFlags, remoteControl: false };
   const catalogue = selectedProvider === void 0 ? void 0 : parseCatalogueCache(params.fs.readFileUtf8(catalogueCachePath(paths, selectedProvider.name)));
   const pickerSettings = selectedProvider === void 0 ? void 0 : modelPickerSettings(selectedProvider.definition, catalogue?.models);
   const callerSettings = hasSettingsArgument(parsedArgv.rest);
-  if (pickerSettings !== void 0 && callerSettings && !readOnly) {
-    log.info("agent-shim: this launch passes its own --settings, so /model keeps Claude Code's own model names instead of listing the provider's models");
+  if (pickerSettings !== void 0 && callerSettings) {
+    notes.push("--settings was passed, so /model keeps Claude Code's own model names");
   }
   const launcherSettings = mergeSettings([params.supervised?.settings, callerSettings ? void 0 : pickerSettings]);
   const args = buildArgv({
@@ -8791,8 +8887,8 @@ function decideLaunch(params, readOnly) {
   return {
     parsedArgv,
     identityDecision,
-    poolExplanation,
     poolPick,
+    notes,
     configDirEscapeHatch: configDirEscapeHatchApplies,
     farmIdentity,
     farmContext,
@@ -8812,10 +8908,18 @@ function prepareLaunch(params) {
   const { paths, proc, log } = params;
   const { env } = proc;
   const decided = decideLaunch(params, false);
-  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolExplanation, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
-  log.info(
-    `agent-shim: identity ${identityDecision.name ?? "(none)"} (${identityDecision.source}${poolExplanation === void 0 ? "" : `, ${poolExplanation}`}), config profile ${configProfileDecision.name ?? "(none)"} (${configProfileDecision.source})` + (resolvedProvider === void 0 ? "" : `, provider ${resolvedProvider.name} (credential ${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)})`) + (identityCredential === void 0 ? "" : `, identity credential ${identityCredential.target} from ${describeSource(identityCredential.source)}`)
-  );
+  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
+  const rows = [
+    ...decisionRows({
+      identity: identityDecision.name,
+      identitySource: identityDecision.source,
+      pool: poolPick,
+      profile: configProfileDecision.name === void 0 ? void 0 : { name: configProfileDecision.name, source: configProfileDecision.source },
+      provider: resolvedProvider === void 0 ? void 0 : { name: resolvedProvider.name, credential: `${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)}` },
+      identityCredential: identityCredential === void 0 ? void 0 : `${identityCredential.target} from ${describeSource(identityCredential.source)}`
+    })
+  ];
+  let warnings = [];
   const updateCheck = runLaunchUpdateCheck({
     mode: params.updateMode ?? "off",
     checkPath: path39.join(paths.root, "update.check"),
@@ -8850,15 +8954,13 @@ function prepareLaunch(params) {
       }
       throw error;
     }
-    reportDiagnostics(log, result.diagnostics, { errorsAsWarnings: false });
+    warnings = diagnosticLines(result.diagnostics);
     if (!result.noOp) {
-      log.info(
-        `agent-shim: farm at ${result.farmRoot} resynced (${String(result.manifest.links.length)} link(s), ${String(result.manifest.materialised.length)} built director(ies)${result.adopted.length === 0 ? "" : `, ${String(result.adopted.length)} adopted into ${resyncFarmRuntime.claudeHome}`})`
-      );
+      rows.push(farmRow(result.manifest.links.length, result.manifest.materialised.length, result.adopted.length));
     }
   }
   if (decided.pinnedVersion !== void 0) {
-    log.info(`agent-shim: Claude Code ${decided.pinnedVersion.version} (pinned by ${decided.pinnedVersion.source})`);
+    rows.push(pinnedVersionRow(decided.pinnedVersion.version, decided.pinnedVersion.source));
   }
   const frontDoorPort = params.frontdoor;
   const frontDoorEngaged = resolvedProvider !== void 0 || resolvedFlags.headroom || resolvedFlags.trackUsage;
@@ -8874,14 +8976,11 @@ function prepareLaunch(params) {
   const headroomPort = params.headroom;
   if (resolvedFlags.headroom && headroomPort !== void 0) {
     headroom = headroomPort.ensure({ routesProvider: resolvedProvider !== void 0 });
-    const via = resolvedProvider === void 0 ? `OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor?.connectPort ?? 0)}` : `provider ${resolvedProvider.name}`;
-    log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor?.port ?? 0)} with headroom on unix socket ${headroom.socketPath} (${via}, project ${headroom.projectId})`);
   } else if (resolvedFlags.headroom) {
     log.error("agent-shim: headroom routing was requested but this launcher has no headroom port wired; refusing to launch without it.");
     proc.exit(1);
-  } else if (frontDoor !== void 0) {
-    log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor.port)}${resolvedProvider === void 0 ? ` (OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor.connectPort)}, usage recorded)` : ` (provider ${resolvedProvider.name})`}`);
   }
+  rows.push(...routingRows({ frontDoor, headroom, provider: resolvedProvider !== void 0 }));
   const frontDoorRelease = frontDoor === void 0 ? void 0 : frontDoorPort?.release;
   const sessionId = params.supervised?.sessionId ?? randomUUID4();
   const finalEnv = buildEnv({
@@ -8902,6 +9001,9 @@ function prepareLaunch(params) {
       registered();
     }
   };
+  rows.push(...notes.map(noteRow));
+  log.report(rows);
+  printDiagnosticLines(log, warnings, { errorsAsWarnings: false });
   const hold = () => holdBeforeLaunch({ delayMs: resolvedFlags.delayMs, pause: resolvedFlags.pause }, params.hold, log);
   return { bin: decided.bin, args: finalArgv, env: finalEnv, sessionId, release, markChildStarted: updateCheck.markChildStarted, hold, decision };
 }
@@ -8967,6 +9069,7 @@ var init_launcher = __esm({
     init_claudeSession();
     init_diagnostics();
     init_hold();
+    init_launchReport();
     init_modelPicker();
     init_providerCatalogue();
     init_pool();
@@ -9193,6 +9296,7 @@ function prepareClaudeLaunch(options) {
   const refusals = [];
   const log = {
     info: () => void 0,
+    report: () => void 0,
     warn: () => void 0,
     error: (message) => {
       refusals.push(message);
@@ -9214,6 +9318,7 @@ function resolveClaudeLaunch(options) {
   const warnings = [];
   const log = {
     info: () => void 0,
+    report: () => void 0,
     warn: (message) => {
       warnings.push(message);
     },
@@ -9419,6 +9524,7 @@ async function withIdentityClaude(params, identity, flags, use) {
       },
       log: {
         info: () => void 0,
+        report: () => void 0,
         warn: () => void 0,
         error: (message) => {
           refusals.push(message);

package/dist/types/index.d.ts

@@ -2390,9 +2390,22 @@ interface ProcPort {
     readonly argv: readonly string[];
     readonly exit: (code: number) => never;
 }
+/** One fact the launcher reports about the launch it is about to start. */
+interface ReportRow {
+    /** What the fact is about (`identity`, `routing`), in a column of its own. */
+    readonly label: string;
+    /** The fact itself. */
+    readonly value: string;
+    /** What qualifies the value, after it and dimmed: where it came from, or how it was reached. */
+    readonly detail?: string;
+    /** Further lines under the row, lined up under its value and dimmed. */
+    readonly notes?: readonly string[];
+}
 /** Where the launcher reports what it decided and why — refusals, warnings about an identity that could not be loaded, and (per the "strictly-better than the legacy script" goal) which identity/profile ended up selected. */
 interface LogPort {
     readonly info: (message: string) => void;
+    /** Prints the facts a launch reports about itself as one block, with the formatting the output takes. */
+    readonly report: (rows: readonly ReportRow[]) => void;
     readonly warn: (message: string) => void;
     readonly error: (message: string) => void;
 }
@@ -5878,7 +5891,6 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                 kind: zod.ZodLiteral<"profile">;
                 name: zod.ZodString;
                 value: zod.ZodObject<{
-                    description: zod.ZodOptional<zod.ZodString>;
                     entries: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<readonly [zod.ZodBoolean, zod.ZodObject<{
                         value: zod.ZodBoolean;
                         when: zod.ZodUnion<readonly [zod.ZodObject<{
@@ -5954,6 +5966,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                             key: zod.ZodType<trilean.JsonValue, unknown, zod_v4_core.$ZodTypeInternals<trilean.JsonValue, unknown>>;
                         }, zod_v4_core.$strip>], "kind">]>;
                     }, zod_v4_core.$strict>]>>>;
+                    description: zod.ZodOptional<zod.ZodString>;
                     extends: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
                     categories: zod.ZodOptional<zod.ZodPipe<zod.ZodObject<{
                         all: zod.ZodOptional<zod.ZodBoolean>;
@@ -6001,7 +6014,6 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                 kind: zod.ZodLiteral<"profile">;
                 name: zod.ZodString;
                 value: zod.ZodObject<{
-                    description: zod.ZodOptional<zod.ZodString>;
                     entries: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<readonly [zod.ZodBoolean, zod.ZodObject<{
                         value: zod.ZodBoolean;
                         when: zod.ZodUnion<readonly [zod.ZodObject<{
@@ -6077,6 +6089,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                             key: zod.ZodType<trilean.JsonValue, unknown, zod_v4_core.$ZodTypeInternals<trilean.JsonValue, unknown>>;
                         }, zod_v4_core.$strip>], "kind">]>;
                     }, zod_v4_core.$strict>]>>>;
+                    description: zod.ZodOptional<zod.ZodString>;
                     extends: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
                     categories: zod.ZodOptional<zod.ZodPipe<zod.ZodObject<{
                         all: zod.ZodOptional<zod.ZodBoolean>;
@@ -7385,7 +7398,7 @@ interface LaunchPlan {
     readonly sessionId: string;
     /** Releases the daemon session registrations this launch holds. Call it when the child has exited; it is safe to call more than once. */
     readonly release: () => void;
-    /** What the launch resolved to, as data: the facts the launcher's decision line reports. */
+    /** What the launch resolved to, as data: the facts the launcher's report states. */
     readonly decision: LaunchDecision;
     /** Marks the moment this plan's child is spawned: the launch-time update check suppresses its notify line from then on, since a line printed after the child took over the terminal would land mid-session. Call it immediately before spawning; it is safe to call more than once. */
     readonly markChildStarted: () => void;
@@ -8900,7 +8913,6 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                 kind: zod.ZodLiteral<"profile">;
                 name: zod.ZodString;
                 value: zod.ZodObject<{
-                    description: zod.ZodOptional<zod.ZodString>;
                     entries: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<readonly [zod.ZodBoolean, zod.ZodObject<{
                         value: zod.ZodBoolean;
                         when: zod.ZodUnion<readonly [zod.ZodObject<{
@@ -8976,6 +8988,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                             key: zod.ZodType<trilean.JsonValue, unknown, zod_v4_core.$ZodTypeInternals<trilean.JsonValue, unknown>>;
                         }, zod_v4_core.$strip>], "kind">]>;
                     }, zod_v4_core.$strict>]>>>;
+                    description: zod.ZodOptional<zod.ZodString>;
                     extends: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
                     categories: zod.ZodOptional<zod.ZodPipe<zod.ZodObject<{
                         all: zod.ZodOptional<zod.ZodBoolean>;
@@ -9023,7 +9036,6 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                 kind: zod.ZodLiteral<"profile">;
                 name: zod.ZodString;
                 value: zod.ZodObject<{
-                    description: zod.ZodOptional<zod.ZodString>;
                     entries: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<readonly [zod.ZodBoolean, zod.ZodObject<{
                         value: zod.ZodBoolean;
                         when: zod.ZodUnion<readonly [zod.ZodObject<{
@@ -9099,6 +9111,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                             key: zod.ZodType<trilean.JsonValue, unknown, zod_v4_core.$ZodTypeInternals<trilean.JsonValue, unknown>>;
                         }, zod_v4_core.$strip>], "kind">]>;
                     }, zod_v4_core.$strict>]>>>;
+                    description: zod.ZodOptional<zod.ZodString>;
                     extends: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
                     categories: zod.ZodOptional<zod.ZodPipe<zod.ZodObject<{
                         all: zod.ZodOptional<zod.ZodBoolean>;
@@ -11037,7 +11050,6 @@ declare const ConfigProfileAddOutputSchema: z.ZodObject<{
     kind: z.ZodLiteral<"profile">;
     name: z.ZodString;
     value: z.ZodObject<{
-        description: z.ZodOptional<z.ZodString>;
         entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             value: z.ZodBoolean;
             when: z.ZodUnion<readonly [z.ZodObject<{
@@ -11113,6 +11125,7 @@ declare const ConfigProfileAddOutputSchema: z.ZodObject<{
                 key: z.ZodType<trilean.JsonValue, unknown, z.core.$ZodTypeInternals<trilean.JsonValue, unknown>>;
             }, z.core.$strip>], "kind">]>;
         }, z.core.$strict>]>>>;
+        description: z.ZodOptional<z.ZodString>;
         extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
         categories: z.ZodOptional<z.ZodPipe<z.ZodObject<{
             all: z.ZodOptional<z.ZodBoolean>;
@@ -11162,7 +11175,6 @@ declare const ConfigProfileSetOutputSchema: z.ZodObject<{
     kind: z.ZodLiteral<"profile">;
     name: z.ZodString;
     value: z.ZodObject<{
-        description: z.ZodOptional<z.ZodString>;
         entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             value: z.ZodBoolean;
             when: z.ZodUnion<readonly [z.ZodObject<{
@@ -11238,6 +11250,7 @@ declare const ConfigProfileSetOutputSchema: z.ZodObject<{
                 key: z.ZodType<trilean.JsonValue, unknown, z.core.$ZodTypeInternals<trilean.JsonValue, unknown>>;
             }, z.core.$strip>], "kind">]>;
         }, z.core.$strict>]>>>;
+        description: z.ZodOptional<z.ZodString>;
         extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
         categories: z.ZodOptional<z.ZodPipe<z.ZodObject<{
             all: z.ZodOptional<z.ZodBoolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-use",
-  "version": "11.28.0",
+  "version": "11.29.0",
   "description": "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
   "license": "MIT",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",