free-coding-models 0.3.5 → 0.3.6

package/src/key-handler.js

@@ -171,6 +171,7 @@ export function createKeyHandler(ctx) {
     saveAsProfile,
     setActiveProfile,
     saveConfig,
+    persistApiKeysForProvider,
     getConfiguredInstallableProviders,
     getInstallTargetModes,
     getProviderCatalogModels,
@@ -405,7 +406,7 @@ export function createKeyHandler(ctx) {
           })
           setActiveProfile(state.config, name)
           state.activeProfile = name
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: [name] })
         }
         state.profileSaveMode = false
         state.profileSaveBuffer = ''
@@ -985,14 +986,24 @@ const updateRowIdx = providerKeys.length
               setTimeout(() => { state.settingsErrorMsg = null }, 3000)
               return
             }
+            if (!state.config.apiKeys || typeof state.config.apiKeys !== 'object' || Array.isArray(state.config.apiKeys)) {
+              state.config.apiKeys = {}
+            }
             if (state.settingsAddKeyMode) {
               // 📖 Add-key mode: append new key (addApiKey handles duplicates/empty)
               addApiKey(state.config, pk, newKey)
             } else {
-              // 📖 Edit mode: replace the primary key (string-level)
-              state.config.apiKeys[pk] = newKey
+              // 📖 Edit mode: replace only the primary key and keep any extra rotated keys intact.
+              const existingKeys = resolveApiKeys(state.config, pk)
+              state.config.apiKeys[pk] = existingKeys.length > 1
+                ? [newKey, ...existingKeys.slice(1)]
+                : newKey
+            }
+            const saveResult = persistApiKeysForProvider(state.config, pk)
+            if (!saveResult.success) {
+              state.settingsErrorMsg = `⚠️  Failed to persist ${pk} API key: ${saveResult.error || 'Unknown error'}`
+              setTimeout(() => { state.settingsErrorMsg = null }, 4000)
             }
-            saveConfig(state.config)
           }
           state.settingsEditMode = false
           state.settingsAddKeyMode = false
@@ -1103,7 +1114,7 @@ const updateRowIdx = providerKeys.length
         if (state.settingsCursor === widthWarningRowIdx) {
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.disableWidthsWarning = !state.config.settings.disableWidthsWarning
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           return
         }
 
@@ -1156,7 +1167,10 @@ const updateRowIdx = providerKeys.length
               applyTierFilter()
               const visible = state.results.filter(r => !r.hidden)
               state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
-              saveConfig(state.config)
+              saveConfig(state.config, {
+                replaceApiKeys: true,
+                replaceFavorites: true,
+              })
             }
           }
           return
@@ -1164,7 +1178,7 @@ const updateRowIdx = providerKeys.length
 
         // 📖 Enter edit mode for the selected provider's key
         const pk = providerKeys[state.settingsCursor]
-        state.settingsEditBuffer = state.config.apiKeys?.[pk] ?? ''
+        state.settingsEditBuffer = resolveApiKeys(state.config, pk)[0] ?? ''
         state.settingsEditMode = true
         return
       }
@@ -1176,7 +1190,7 @@ const updateRowIdx = providerKeys.length
         if (state.settingsCursor === widthWarningRowIdx) {
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.disableWidthsWarning = !state.config.settings.disableWidthsWarning
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           return
         }
         // 📖 Profile rows don't respond to Space
@@ -1187,7 +1201,7 @@ const updateRowIdx = providerKeys.length
         if (!state.config.providers) state.config.providers = {}
         if (!state.config.providers[pk]) state.config.providers[pk] = { enabled: true }
         state.config.providers[pk].enabled = !isProviderEnabled(state.config, pk)
-        saveConfig(state.config)
+        saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
         return
       }
 
@@ -1218,7 +1232,7 @@ const updateRowIdx = providerKeys.length
             setActiveProfile(state.config, null)
             state.activeProfile = null
           }
-          saveConfig(state.config)
+          saveConfig(state.config, { removedProfileNames: [profileName] })
           // 📖 Re-clamp cursor after deletion (profile list just got shorter)
           const newProfiles = listProfiles(state.config)
           const newMaxRowIdx = newProfiles.length > 0 ? profileStartIdx + newProfiles.length - 1 : changelogViewRowIdx
@@ -1285,7 +1299,11 @@ const updateRowIdx = providerKeys.length
         const pk = providerKeys[state.settingsCursor]
         const removed = removeApiKey(state.config, pk)  // removes last key; collapses array-of-1 to string
         if (removed) {
-          saveConfig(state.config)
+          const saveResult = persistApiKeysForProvider(state.config, pk)
+          if (!saveResult.success) {
+            state.settingsSyncStatus = { type: 'error', msg: `❌ Failed to save API key changes: ${saveResult.error || 'Unknown error'}` }
+            return
+          }
           const remaining = resolveApiKeys(state.config, pk).length
           const msg = remaining > 0
             ? `✅ Removed one key for ${pk} (${remaining} remaining)`
@@ -1325,7 +1343,7 @@ const updateRowIdx = providerKeys.length
           }
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.proxy = { ...proxySettings, preferredPort: parsed }
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           state.settingsProxyPortEditMode = false
           state.settingsProxyPortBuffer = ''
           state.proxyDaemonMessage = { type: 'success', msg: `✅ Preferred port saved: ${parsed === 0 ? 'auto' : parsed}`, ts: Date.now() }
@@ -1366,7 +1384,7 @@ const updateRowIdx = providerKeys.length
         if (state.proxyDaemonCursor === ROW_PROXY_ENABLED) {
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.proxy = { ...proxySettings, enabled: !proxySettings.enabled }
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           state.proxyDaemonMessage = { type: 'success', msg: `✅ Proxy mode ${state.config.settings.proxy.enabled ? 'enabled' : 'disabled'}`, ts: Date.now() }
           return
         }
@@ -1377,7 +1395,7 @@ const updateRowIdx = providerKeys.length
           }
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.proxy = { ...proxySettings, syncToOpenCode: !proxySettings.syncToOpenCode }
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           const { getToolMeta } = await import('./tool-metadata.js')
           const toolLabel = getToolMeta(currentProxyTool).label
           state.proxyDaemonMessage = { type: 'success', msg: `✅ Auto-sync to ${toolLabel} ${state.config.settings.proxy.syncToOpenCode ? 'enabled' : 'disabled'}`, ts: Date.now() }
@@ -1393,7 +1411,7 @@ const updateRowIdx = providerKeys.length
         if (state.proxyDaemonCursor === ROW_PROXY_ENABLED) {
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.proxy = { ...proxySettings, enabled: !proxySettings.enabled }
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           state.proxyDaemonMessage = { type: 'success', msg: `✅ Proxy mode ${state.config.settings.proxy.enabled ? 'enabled' : 'disabled'}`, ts: Date.now() }
           return
         }
@@ -1406,7 +1424,7 @@ const updateRowIdx = providerKeys.length
           }
           if (!state.config.settings) state.config.settings = {}
           state.config.settings.proxy = { ...proxySettings, syncToOpenCode: !proxySettings.syncToOpenCode }
-          saveConfig(state.config)
+          saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
           const { getToolMeta } = await import('./tool-metadata.js')
           const toolLabel = getToolMeta(currentProxyTool).label
           state.proxyDaemonMessage = { type: 'success', msg: `✅ Auto-sync to ${toolLabel} ${state.config.settings.proxy.syncToOpenCode ? 'enabled' : 'disabled'}`, ts: Date.now() }
@@ -1456,7 +1474,7 @@ const updateRowIdx = providerKeys.length
             if (!state.config.settings.proxy.preferredPort || state.config.settings.proxy.preferredPort === 0) {
               state.config.settings.proxy.preferredPort = 18045
             }
-            saveConfig(state.config)
+            saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
             const result = installDaemon()
             if (result.success) {
               state.proxyDaemonMessage = { type: 'success', msg: '✅ FCM Proxy V2 background service installed and started!', ts: Date.now() }
@@ -1470,7 +1488,7 @@ const updateRowIdx = providerKeys.length
             // 📖 Uninstall daemon
             const result = uninstallDaemon()
             state.config.settings.proxy.daemonEnabled = false
-            saveConfig(state.config)
+            saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
             if (result.success) {
               state.proxyDaemonMessage = { type: 'success', msg: '✅ FCM Proxy V2 background service uninstalled.', ts: Date.now() }
               state.daemonStatus = 'not-installed'
@@ -1629,7 +1647,7 @@ const updateRowIdx = providerKeys.length
         })
         setActiveProfile(state.config, 'default')
         state.activeProfile = 'default'
-        saveConfig(state.config)
+        saveConfig(state.config, { replaceProfileNames: ['default'] })
       } else {
         // 📖 Cycle to next profile (or back to null = raw config)
         const currentIdx = state.activeProfile ? profiles.indexOf(state.activeProfile) : -1
@@ -1662,7 +1680,10 @@ const updateRowIdx = providerKeys.length
             state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
             state.cursor = 0
             state.scrollOffset = 0
-            saveConfig(state.config)
+            saveConfig(state.config, {
+              replaceApiKeys: true,
+              replaceFavorites: true,
+            })
           }
         }
       }
@@ -1693,7 +1714,7 @@ const updateRowIdx = providerKeys.length
         profile.settings.sortColumn = state.config.settings.sortColumn
         profile.settings.sortAsc = state.config.settings.sortAsc
       }
-      saveConfig(state.config)
+      saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
     }
 
     // 📖 Shift+R: reset all UI view settings to defaults (tier, sort, provider) and clear persisted config
@@ -1717,7 +1738,7 @@ const updateRowIdx = providerKeys.length
           delete profile.settings.sortAsc
         }
       }
-      saveConfig(state.config)
+      saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
       applyTierFilter()
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
@@ -1824,7 +1845,7 @@ const updateRowIdx = providerKeys.length
         if (!profile.settings || typeof profile.settings !== 'object') profile.settings = {}
         profile.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
       }
-      saveConfig(state.config)
+      saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
       applyTierFilter()
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
@@ -1891,7 +1912,7 @@ const updateRowIdx = providerKeys.length
         if (!profile.settings || typeof profile.settings !== 'object') profile.settings = {}
         profile.settings.preferredToolMode = state.mode
       }
-      saveConfig(state.config)
+      saveConfig(state.config, { replaceProfileNames: state.activeProfile ? [state.activeProfile] : [] })
       return
     }
 

package/src/testfcm.js

@@ -0,0 +1,451 @@
+/**
+ * @file src/testfcm.js
+ * @description Shared helpers for the AI-driven `/testfcm` workflow.
+ *
+ * @details
+ *   📖 These helpers stay side-effect free on purpose so the reporting logic can
+ *   📖 be unit-tested without spawning a PTY or touching the user's machine.
+ *
+ *   📖 The runner in `scripts/testfcm-runner.mjs` handles the live terminal work:
+ *   📖 copying config into an isolated HOME, driving the TUI, launching a tool,
+ *   📖 sending a prompt, collecting logs, and writing the final Markdown report.
+ *   📖 This module focuses on the pieces that should remain stable and reusable:
+ *   📖 tool metadata, transcript classification, JSON extraction, and report text.
+ *
+ * @functions
+ *   → `normalizeTestfcmToolName` — map aliases like `claude` to canonical FCM tool modes
+ *   → `resolveTestfcmToolSpec` — return the runner metadata for one tool mode
+ *   → `hasConfiguredKey` — decide whether a config entry really contains an API key
+ *   → `createTestfcmRunId` — build a stable timestamp-based run id for artifacts
+ *   → `extractJsonPayload` — recover JSON mode output even when logs prefix stdout
+ *   → `detectTranscriptFindings` — map raw tool output to actionable failure findings
+ *   → `classifyToolTranscript` — classify a run as passed, failed, or inconclusive
+ *   → `buildFixTasks` — convert findings into concrete follow-up work items
+ *   → `buildTestfcmReport` — render the final Markdown report written under `task/`
+ *
+ * @exports TESTFCM_TOOL_SPECS, normalizeTestfcmToolName, resolveTestfcmToolSpec
+ * @exports hasConfiguredKey, createTestfcmRunId, extractJsonPayload
+ * @exports detectTranscriptFindings, classifyToolTranscript, buildFixTasks
+ * @exports buildTestfcmReport
+ */
+
+export const TESTFCM_TOOL_SPECS = {
+  crush: {
+    mode: 'crush',
+    label: 'Crush',
+    command: 'crush',
+    flag: '--crush',
+    prefersProxy: true,
+    configPaths: ['.config/crush/crush.json'],
+  },
+  codex: {
+    mode: 'codex',
+    label: 'Codex CLI',
+    command: 'codex',
+    flag: '--codex',
+    prefersProxy: true,
+    configPaths: [],
+  },
+  'claude-code': {
+    mode: 'claude-code',
+    label: 'Claude Code',
+    command: 'claude',
+    flag: '--claude-code',
+    prefersProxy: true,
+    configPaths: [],
+  },
+  gemini: {
+    mode: 'gemini',
+    label: 'Gemini CLI',
+    command: 'gemini',
+    flag: '--gemini',
+    prefersProxy: true,
+    configPaths: ['.gemini/settings.json'],
+  },
+  goose: {
+    mode: 'goose',
+    label: 'Goose',
+    command: 'goose',
+    flag: '--goose',
+    prefersProxy: true,
+    configPaths: ['.config/goose/config.yaml'],
+  },
+  aider: {
+    mode: 'aider',
+    label: 'Aider',
+    command: 'aider',
+    flag: '--aider',
+    prefersProxy: false,
+    configPaths: ['.aider.conf.yml'],
+  },
+  qwen: {
+    mode: 'qwen',
+    label: 'Qwen Code',
+    command: 'qwen',
+    flag: '--qwen',
+    prefersProxy: false,
+    configPaths: ['.qwen/settings.json'],
+  },
+  amp: {
+    mode: 'amp',
+    label: 'Amp',
+    command: 'amp',
+    flag: '--amp',
+    prefersProxy: false,
+    configPaths: ['.config/amp/settings.json'],
+  },
+  pi: {
+    mode: 'pi',
+    label: 'Pi',
+    command: 'pi',
+    flag: '--pi',
+    prefersProxy: false,
+    configPaths: ['.pi/agent/models.json', '.pi/agent/settings.json'],
+  },
+  opencode: {
+    mode: 'opencode',
+    label: 'OpenCode CLI',
+    command: 'opencode',
+    flag: '--opencode',
+    prefersProxy: false,
+    configPaths: ['.config/opencode/opencode.json'],
+  },
+  openhands: {
+    mode: 'openhands',
+    label: 'OpenHands',
+    command: 'openhands',
+    flag: '--openhands',
+    prefersProxy: false,
+    configPaths: [],
+  },
+}
+
+const TESTFCM_TOOL_ALIASES = {
+  claude: 'claude-code',
+  claudecode: 'claude-code',
+  codexcli: 'codex',
+  opencodecli: 'opencode',
+}
+
+const TRANSCRIPT_FINDING_RULES = [
+  {
+    id: 'tool_missing',
+    title: 'Tool binary missing',
+    severity: 'high',
+    regex: /could not find "[^"]+" in path|command not found|enoent/i,
+    task: 'Install the requested tool binary or pass `--tool-bin-dir` so FCM can launch it during `/testfcm`.',
+  },
+  {
+    id: 'invalid_api_key',
+    title: 'Invalid or missing API auth',
+    severity: 'high',
+    regex: /invalid api|bad api key|incorrect api key|authentication failed|unauthorized|forbidden|missing api key|no api key|anthropic_auth_token|401\b|403\b/i,
+    task: 'Validate the provider key used by the selected model, then re-run `/testfcm` and inspect the proxy request log for the failing request.',
+  },
+  {
+    id: 'rate_limited',
+    title: 'Provider rate limited',
+    severity: 'medium',
+    regex: /rate limit|too many requests|quota exceeded|429\b/i,
+    task: 'Retry with another configured provider or inspect the retry-after and cooldown handling in the proxy/tool launch flow.',
+  },
+  {
+    id: 'proxy_failure',
+    title: 'Proxy startup or routing failure',
+    severity: 'high',
+    regex: /failed to start proxy|proxy mode .* required|selected model may not exist|routing reload is taking longer than expected|proxy launch is blocked/i,
+    task: 'Inspect `request-log.jsonl`, proxy startup messages, and the isolated config to verify the tool can reach the local FCM proxy.',
+  },
+  {
+    id: 'tool_launch_failed',
+    title: 'Tool launch failed',
+    severity: 'high',
+    regex: /failed to launch|failed to start|process exited with code 1|syntaxerror|traceback|fatal:/i,
+    task: 'Inspect the tool transcript and generated tool config under the isolated HOME to find the exact launcher failure.',
+  },
+]
+
+const SUCCESS_PATTERNS = [
+  /hello[,! ]/i,
+  /how can i help/i,
+  /how may i help/i,
+  /how can i assist/i,
+  /ready to help/i,
+]
+
+/**
+ * 📖 Normalize a user/tool alias to the canonical FCM tool mode.
+ *
+ * @param {string | null | undefined} value
+ * @returns {string | null}
+ */
+export function normalizeTestfcmToolName(value) {
+  if (typeof value !== 'string' || value.trim().length === 0) return null
+  const normalized = value.trim().toLowerCase()
+  return TESTFCM_TOOL_ALIASES[normalized] || normalized
+}
+
+/**
+ * 📖 Resolve one `/testfcm` tool spec from user input.
+ *
+ * @param {string | null | undefined} value
+ * @returns {typeof TESTFCM_TOOL_SPECS[keyof typeof TESTFCM_TOOL_SPECS] | null}
+ */
+export function resolveTestfcmToolSpec(value) {
+  const normalized = normalizeTestfcmToolName(value)
+  if (!normalized) return null
+  return TESTFCM_TOOL_SPECS[normalized] || null
+}
+
+/**
+ * 📖 Treat both string and multi-key array config entries as "configured" when at
+ * 📖 least one non-empty key is present.
+ *
+ * @param {unknown} value
+ * @returns {boolean}
+ */
+export function hasConfiguredKey(value) {
+  if (typeof value === 'string') return value.trim().length > 0
+  if (Array.isArray(value)) return value.some((entry) => typeof entry === 'string' && entry.trim().length > 0)
+  return false
+}
+
+/**
+ * 📖 Build an artifact-friendly run id such as `20260316-184512`.
+ *
+ * @param {Date} [date]
+ * @returns {string}
+ */
+export function createTestfcmRunId(date = new Date()) {
+  const iso = date.toISOString()
+  return iso
+    .replace(/\.\d{3}Z$/, '')
+    .replace(/:/g, '')
+    .replace(/-/g, '')
+    .replace('T', '-')
+}
+
+/**
+ * 📖 Extract the first valid JSON array payload from mixed stdout text.
+ *
+ * @param {string} text
+ * @returns {Array<object> | null}
+ */
+export function extractJsonPayload(text) {
+  const source = String(text || '')
+  let offset = source.indexOf('[')
+  while (offset !== -1) {
+    const candidate = source.slice(offset).trim()
+    try {
+      const parsed = JSON.parse(candidate)
+      return Array.isArray(parsed) ? parsed : null
+    } catch {
+      offset = source.indexOf('[', offset + 1)
+    }
+  }
+  return null
+}
+
+/**
+ * 📖 Detect known failure patterns in the raw tool transcript.
+ *
+ * @param {string} output
+ * @returns {Array<{ id: string, title: string, severity: string, task: string, excerpt: string }>}
+ */
+export function detectTranscriptFindings(output) {
+  const transcript = String(output || '')
+  const findings = []
+
+  for (const rule of TRANSCRIPT_FINDING_RULES) {
+    const match = transcript.match(rule.regex)
+    if (!match) continue
+
+    findings.push({
+      id: rule.id,
+      title: rule.title,
+      severity: rule.severity,
+      task: rule.task,
+      excerpt: match[0],
+    })
+  }
+
+  return findings
+}
+
+/**
+ * 📖 Decide whether the tool transcript proves success, proves failure, or stays
+ * 📖 too ambiguous to trust.
+ *
+ * @param {string} output
+ * @returns {{ status: 'passed' | 'failed' | 'inconclusive', findings: Array<{ id: string, title: string, severity: string, task: string, excerpt: string }>, matchedSuccess: string | null }}
+ */
+export function classifyToolTranscript(output) {
+  const transcript = String(output || '')
+  const matchedSuccess = SUCCESS_PATTERNS.find((pattern) => pattern.test(transcript))
+
+  if (matchedSuccess) {
+    return {
+      status: 'passed',
+      findings: [],
+      matchedSuccess: matchedSuccess.source,
+    }
+  }
+
+  const findings = detectTranscriptFindings(transcript)
+  if (findings.length > 0) {
+    return {
+      status: 'failed',
+      findings,
+      matchedSuccess: null,
+    }
+  }
+
+  return {
+    status: 'inconclusive',
+    findings: [],
+    matchedSuccess: null,
+  }
+}
+
+/**
+ * 📖 Collapse findings into unique human-readable follow-up tasks.
+ *
+ * @param {Array<{ task: string }>} findings
+ * @returns {string[]}
+ */
+export function buildFixTasks(findings) {
+  const tasks = new Set()
+  for (const finding of findings) {
+    if (typeof finding?.task === 'string' && finding.task.trim().length > 0) {
+      tasks.add(finding.task.trim())
+    }
+  }
+  return [...tasks]
+}
+
+/**
+ * 📖 Render the final Markdown report saved under `task/reports/`.
+ *
+ * @param {{
+ *   runId: string,
+ *   status: 'passed' | 'failed' | 'blocked',
+ *   startedAt: string,
+ *   finishedAt: string,
+ *   toolLabel: string,
+ *   toolMode: string,
+ *   prompt: string,
+ *   configuredProviders: string[],
+ *   toolBinaryPath: string | null,
+ *   isolatedHome: string,
+ *   preflightSummary: string,
+ *   findings: Array<{ id: string, title: string, severity: string, excerpt: string }>,
+ *   tasks: string[],
+ *   evidenceFiles: string[],
+ *   requestLogSummary: string[],
+ *   notes: string[],
+ *   transcriptExcerpt: string
+ * }} input
+ * @returns {string}
+ */
+export function buildTestfcmReport(input) {
+  const lines = []
+  const findings = Array.isArray(input.findings) ? input.findings : []
+  const tasks = Array.isArray(input.tasks) ? input.tasks : []
+  const evidenceFiles = Array.isArray(input.evidenceFiles) ? input.evidenceFiles : []
+  const requestLogSummary = Array.isArray(input.requestLogSummary) ? input.requestLogSummary : []
+  const notes = Array.isArray(input.notes) ? input.notes : []
+  const configuredProviders = Array.isArray(input.configuredProviders) ? input.configuredProviders : []
+  const transcriptExcerpt = String(input.transcriptExcerpt || '').trim()
+
+  lines.push(`# /testfcm Report - ${input.runId}`)
+  lines.push('')
+  lines.push(`- Status: **${input.status.toUpperCase()}**`)
+  lines.push(`- Started: ${input.startedAt}`)
+  lines.push(`- Finished: ${input.finishedAt}`)
+  lines.push(`- Tool: ${input.toolLabel} (${input.toolMode})`)
+  lines.push(`- Prompt sent: \`${input.prompt}\``)
+  lines.push(`- Configured providers in isolated run: ${configuredProviders.length > 0 ? configuredProviders.join(', ') : '(none)'}`)
+  lines.push(`- Tool binary: ${input.toolBinaryPath || '(not found on PATH)'}`)
+  lines.push(`- Isolated HOME: \`${input.isolatedHome}\``)
+  lines.push('')
+  lines.push('## Summary')
+  lines.push('')
+  lines.push(input.preflightSummary)
+  lines.push('')
+
+  if (findings.length > 0) {
+    lines.push('## Bugs Found')
+    lines.push('')
+    for (const finding of findings) {
+      lines.push(`- [${finding.severity}] ${finding.title} - evidence: \`${finding.excerpt}\``)
+    }
+    lines.push('')
+  } else {
+    lines.push('## Bugs Found')
+    lines.push('')
+    lines.push('- No blocking bug pattern matched the captured transcript in this run.')
+    lines.push('')
+  }
+
+  lines.push('## Tasks To Resolve')
+  lines.push('')
+  if (tasks.length > 0) {
+    for (const task of tasks) {
+      lines.push(`- ${task}`)
+    }
+  } else {
+    lines.push('- No follow-up task was generated from the captured evidence.')
+  }
+  lines.push('')
+
+  lines.push('## Evidence')
+  lines.push('')
+  if (evidenceFiles.length > 0) {
+    for (const file of evidenceFiles) {
+      lines.push(`- ${file}`)
+    }
+  } else {
+    lines.push('- No artifact file was captured.')
+  }
+  lines.push('')
+
+  lines.push('## Request Log Summary')
+  lines.push('')
+  if (requestLogSummary.length > 0) {
+    for (const entry of requestLogSummary) {
+      lines.push(`- ${entry}`)
+    }
+  } else {
+    lines.push('- No proxy request log entry was captured for this run.')
+  }
+  lines.push('')
+
+  lines.push('## Notes')
+  lines.push('')
+  if (notes.length > 0) {
+    for (const note of notes) {
+      lines.push(`- ${note}`)
+    }
+  } else {
+    lines.push('- No extra notes.')
+  }
+  lines.push('')
+
+  lines.push('## Transcript Excerpt')
+  lines.push('')
+  if (transcriptExcerpt) {
+    lines.push('```text')
+    lines.push(transcriptExcerpt)
+    lines.push('```')
+  } else {
+    lines.push('```text')
+    lines.push('(empty transcript excerpt)')
+    lines.push('```')
+  }
+  lines.push('')
+  lines.push('## Next Step')
+  lines.push('')
+  lines.push('Ask the AI to read this report, summarize the blockers, and propose or apply the fixes.')
+
+  return lines.join('\n')
+}