mio-agent-runtime 0.13.3 → 0.13.5

package/adapters/workbuddy.js

@@ -1,196 +1,197 @@
-'use strict'
-
-const fs = require('fs')
-const path = require('path')
-const os = require('os')
-const crypto = require('crypto')
-
-function configDir() {
-  return (
-    process.env.WORKBUDDY_CONFIG_DIR ||
-    process.env.CODEBUDDY_CONFIG_DIR ||
-    path.join(os.homedir(), '.workbuddy')
-  )
-}
-
-function configPath() {
-  return path.join(configDir(), 'mcp.json')
-}
-
-function legacyConfigPath() {
-  return path.join(configDir(), '.mcp.json')
-}
-
-function approvalsPath() {
-  return path.join(configDir(), 'mcp-approvals.json')
-}
-
-// User-level memory rules file. WorkBuddy's codebuddy CLI (a CodeBuddy fork)
-// auto-loads CODEBUDDY.md (or CODEBUDDY.mdc) from the config dir into every
-// session (MemoryLoader user scope -> system-reminder-md / prompt context).
-// Note: PRODUCT_UPPERCASE_NAME in the CLI bundle is "CODEBUDDY", not "WORKBUDDY".
-function memoryRulesPath() {
-  return path.join(configDir(), 'CODEBUDDY.md')
-}
-
-// Project-level memory rules. WorkBuddy walks up from the workspace dir and
-// auto-loads CODEBUDDY.md / AGENTS.md (project scope) into every session.
-function projectInstructionsPath(workspace) {
-  return path.join(workspace || process.cwd(), 'AGENTS.md')
-}
-
-function readJson(file) {
-  if (!fs.existsSync(file)) return null
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'))
-  } catch (_) {
-    return null
-  }
-}
-
-const MEMORY_BEGIN = '<!-- MIO_INTELLIGENCE_BEGIN -->'
-const MEMORY_END = '<!-- MIO_INTELLIGENCE_END -->'
-const MEMORY_BLOCK = `${MEMORY_BEGIN}
-## Mio Intelligence Layer
-
-Mio MCP tools are available. Treat these as mandatory runtime rules for every workspace.
-
-- Before designing or implementing a solution, or when unsure about prior decisions, call \`mio-intelligence_mio.memory.query\` first. Omit \`project\` unless a specific project is required; Mio derives it from the current Git repository.
-- After a decision affecting architecture, deployment, dependencies, or long-term behavior, call \`mio-intelligence_mio.memory.record\` with \`kind\`: \`decision\`, \`context\`, \`problem\`, or \`note\`.
-- When a tool call fails, retries, or returns an error, call \`mio-intelligence_mio.observer.ingest\` with a stable \`trace_id\`, relevant \`event_type\`, \`payload\`, and \`outcome\`.
-- Before a high-risk operation such as deletion, migration, credential change, or production change, call \`mio-intelligence_mio.policy.check\` and follow its suggestion when available.
-- At the end of every task, before producing the final answer, call \`mio-intelligence_mio.observer.ingest\` with \`event_type\` = \`task_outcome\`, a stable \`trace_id\`, \`outcome\` = \`success\` / \`failure\` / \`aborted\`, and a brief non-sensitive \`payload\`. If Mio is unavailable, do not block the final answer.
-- When you reuse a prior decision or experience returned by \`mio-intelligence_mio.memory.query\` and it changes your approach or outcome, call \`mio-intelligence_mio.experience.reuse\` with \`sourceAgent\`, \`targetAgent\`, \`experienceId\`, \`reuse\`, \`behaviorChanged\`, and \`outcomeImproved\`.
-- If Mio MCP is unavailable, do not block the task. Continue normally and note the missed memory or observation.
-- Do not store secrets, credentials, or raw sensitive content in Mio memory.
-${MEMORY_END}`
-
-function ensureBlock(target) {
-  let content = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
-  const original = content
-  const start = content.indexOf(MEMORY_BEGIN)
-  if (start !== -1) {
-    const end = content.indexOf(MEMORY_END, start)
-    content = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + MEMORY_END.length)
-    content = content.trimEnd()
-  }
-  if (content) content += '\n\n'
-  content += MEMORY_BLOCK + '\n'
-  if (content === original) return { changed: false, target, backup: null }
-  const backup = `${target}.bak-mio-${Date.now()}`
-  if (fs.existsSync(target)) fs.copyFileSync(target, backup)
-  fs.mkdirSync(path.dirname(target), { recursive: true })
-  fs.writeFileSync(target, content, 'utf8')
-  return { changed: true, target, backup }
-}
-
-function isInstalled() {
-  const config = readJson(configPath())
-  const entry = config && config.mcpServers && config.mcpServers['mio-intelligence']
-  if (!entry) return false
-
-  const approvals = readJson(approvalsPath()) || {}
-  const memory = fs.existsSync(memoryRulesPath()) ? fs.readFileSync(memoryRulesPath(), 'utf8') : ''
-  return Boolean(
-    approvals[approvalKey('mio-intelligence', entry)] &&
-    memory.includes(MEMORY_BEGIN) &&
-    memory.includes(MEMORY_END)
-  )
-}
-
-function approvalKey(name, entry) {
-  let input
-  if (entry.command) {
-    input = `${entry.command || ''}|${(entry.args || []).map(String).sort().join(',')}|${Object.keys(entry.env || {}).sort().join(',')}`
-  } else if (entry.url) {
-    try {
-      input = new URL(entry.url).origin
-    } catch (_) {
-      input = entry.url
-    }
-  } else {
-    input = JSON.stringify(entry)
-  }
-
-  const hash = crypto.createHash('sha256').update(input).digest('hex')
-  return `${hash}::${name}`
-}
-
-function writeApproval(name, entry) {
-  const target = approvalsPath()
-  const approvals = readJson(target) || {}
-  approvals[approvalKey(name, entry)] = Date.now()
-  fs.mkdirSync(path.dirname(target), { recursive: true })
-  fs.writeFileSync(target, `${JSON.stringify(approvals, null, 2)}\n`, 'utf8')
-}
-
-function install({ node, serverScript, home, workspace, project }) {
-  const target = configPath()
-  const canonical = readJson(target) || {}
-  const legacy = readJson(legacyConfigPath()) || {}
-  const canonicalServers =
-    canonical.mcpServers && typeof canonical.mcpServers === 'object' ? canonical.mcpServers : {}
-  const legacyServers =
-    legacy.mcpServers && typeof legacy.mcpServers === 'object' ? legacy.mcpServers : {}
-
-  const config = {
-    ...legacy,
-    ...canonical,
-    mcpServers: {
-      ...legacyServers,
-      ...canonicalServers,
-    },
-  }
-
-  const context = JSON.stringify({
-    agentId: 'workbuddy',
-    project: project || path.basename(workspace || process.cwd()),
-    workspace: workspace || process.cwd(),
-    sessionId: 'workbuddy-session',
-  })
-
-  config.mcpServers = {
-    ...config.mcpServers,
-    'mio-intelligence': {
-      command: node,
-      args: [serverScript],
-      env: {
-        MIO_DATA_DIR: home,
-        MIO_CONTEXT: context,
-      },
-    },
-  }
-
-  writeApproval('mio-intelligence', config.mcpServers['mio-intelligence'])
-
-  const backup = `${target}.bak-mio-${Date.now()}`
-  if (fs.existsSync(target)) {
-    fs.copyFileSync(target, backup)
-  }
-
-  fs.mkdirSync(path.dirname(target), { recursive: true })
-  fs.writeFileSync(target, `${JSON.stringify(config, null, 2)}\n`, 'utf8')
-
-  const userRules = ensureBlock(memoryRulesPath())
-  let projectRules = null
-  const workspaceDir = workspace || process.cwd()
-  if (workspaceDir && path.isAbsolute(workspaceDir)) {
-    projectRules = ensureBlock(projectInstructionsPath(workspaceDir))
-  }
-
-  const changed = userRules.changed || Boolean(projectRules && projectRules.changed)
-
-  return {
-    changed,
-    configPath: target,
-    approvalsPath: approvalsPath(),
-    memoryRulesPath: userRules.target,
-    projectInstructionsPath: projectRules ? projectRules.target : null,
-    userRulesChanged: userRules.changed,
-    projectRulesChanged: projectRules ? projectRules.changed : false,
-    backup,
-    message: 'WorkBuddy Mio MCP installed, approved, and Mio rules injected into CODEBUDDY.md (auto-loaded user memory) and the workspace AGENTS.md. Restart WorkBuddy to load them.',
-  }
-}
-
-module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install }
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+const crypto = require('crypto')
+
+function configDir() {
+  return (
+    process.env.WORKBUDDY_CONFIG_DIR ||
+    process.env.CODEBUDDY_CONFIG_DIR ||
+    path.join(os.homedir(), '.workbuddy')
+  )
+}
+
+function configPath() {
+  return path.join(configDir(), 'mcp.json')
+}
+
+function legacyConfigPath() {
+  return path.join(configDir(), '.mcp.json')
+}
+
+function approvalsPath() {
+  return path.join(configDir(), 'mcp-approvals.json')
+}
+
+// User-level memory rules file. WorkBuddy's codebuddy CLI (a CodeBuddy fork)
+// auto-loads CODEBUDDY.md (or CODEBUDDY.mdc) from the config dir into every
+// session (MemoryLoader user scope -> system-reminder-md / prompt context).
+// Note: PRODUCT_UPPERCASE_NAME in the CLI bundle is "CODEBUDDY", not "WORKBUDDY".
+function memoryRulesPath() {
+  return path.join(configDir(), 'CODEBUDDY.md')
+}
+
+// Project-level memory rules. WorkBuddy walks up from the workspace dir and
+// auto-loads CODEBUDDY.md / AGENTS.md (project scope) into every session.
+function projectInstructionsPath(workspace) {
+  return path.join(workspace || process.cwd(), 'AGENTS.md')
+}
+
+function readJson(file) {
+  if (!fs.existsSync(file)) return null
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'))
+  } catch (_) {
+    return null
+  }
+}
+
+const MEMORY_BEGIN = '<!-- MIO_INTELLIGENCE_BEGIN -->'
+const MEMORY_END = '<!-- MIO_INTELLIGENCE_END -->'
+const MEMORY_BLOCK = `${MEMORY_BEGIN}
+## Mio Intelligence Layer
+
+Mio MCP tools are available. Treat these as mandatory runtime rules for every workspace.
+
+- Before designing or implementing a solution, or when unsure about prior decisions, call \`mcp__mio-intelligence__mio.memory.query\` first. Omit \`project\` unless a specific project is required; Mio derives it from the current Git repository.
+- After a decision affecting architecture, deployment, dependencies, or long-term behavior, call \`mcp__mio-intelligence__mio.memory.record\` with \`kind\`: \`decision\`, \`context\`, \`problem\`, or \`note\`.
+- When a tool call fails, retries, or returns an error, call \`mcp__mio-intelligence__mio.observer.ingest\` with a stable \`trace_id\`, relevant \`event_type\`, \`payload\`, and \`outcome\`.
+- Before a high-risk operation such as deletion, migration, credential change, or production change, call \`mcp__mio-intelligence__mio.policy.check\` and follow its suggestion when available.
+- At the end of every task, before producing the final answer, call \`mcp__mio-intelligence__mio.observer.ingest\` with \`event_type\` = \`task_outcome\`, a stable \`trace_id\`, \`outcome\` = \`success\` / \`failure\` / \`aborted\`, and a brief non-sensitive \`payload\`. If Mio is unavailable, do not block the final answer.
+- When you reuse a prior decision or experience returned by \`mcp__mio-intelligence__mio.memory.query\` and it changes your approach or outcome, call \`mcp__mio-intelligence__mio.experience.reuse\` with \`sourceAgent\`, \`targetAgent\`, \`experienceId\`, \`reuse\`, \`behaviorChanged\`, and \`outcomeImproved\`.
+- If Mio MCP is unavailable, do not block the task. Continue normally and note the missed memory or observation.
+- Do not store secrets, credentials, or raw sensitive content in Mio memory.
+${MEMORY_END}`
+
+function ensureBlock(target) {
+  let content = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
+  const original = content
+  const start = content.indexOf(MEMORY_BEGIN)
+  if (start !== -1) {
+    const end = content.indexOf(MEMORY_END, start)
+    content = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + MEMORY_END.length)
+    content = content.trimEnd()
+  }
+  if (content) content += '\n\n'
+  content += MEMORY_BLOCK + '\n'
+  if (content === original) return { changed: false, target, backup: null }
+  const backup = `${target}.bak-mio-${Date.now()}`
+  if (fs.existsSync(target)) fs.copyFileSync(target, backup)
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.writeFileSync(target, content, 'utf8')
+  return { changed: true, target, backup }
+}
+
+function isInstalled() {
+  const config = readJson(configPath())
+  const entry = config && config.mcpServers && config.mcpServers['mio-intelligence']
+  if (!entry) return false
+
+  const approvals = readJson(approvalsPath()) || {}
+  const memory = fs.existsSync(memoryRulesPath()) ? fs.readFileSync(memoryRulesPath(), 'utf8') : ''
+  return Boolean(
+    approvals[approvalKey('mio-intelligence', entry)] &&
+    memory.includes(MEMORY_BEGIN) &&
+    memory.includes(MEMORY_END)
+  )
+}
+
+function approvalKey(name, entry) {
+  let input
+  if (entry.command) {
+    input = `${entry.command || ''}|${(entry.args || []).map(String).sort().join(',')}|${Object.keys(entry.env || {}).sort().join(',')}`
+  } else if (entry.url) {
+    try {
+      input = new URL(entry.url).origin
+    } catch (_) {
+      input = entry.url
+    }
+  } else {
+    input = JSON.stringify(entry)
+  }
+
+  const hash = crypto.createHash('sha256').update(input).digest('hex')
+  return `${hash}::${name}`
+}
+
+function writeApproval(name, entry) {
+  const target = approvalsPath()
+  const approvals = readJson(target) || {}
+  approvals[approvalKey(name, entry)] = Date.now()
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.writeFileSync(target, `${JSON.stringify(approvals, null, 2)}\n`, 'utf8')
+}
+
+function install({ node, serverScript, home, workspace }) {
+  const target = configPath()
+  const canonical = readJson(target) || {}
+  const legacy = readJson(legacyConfigPath()) || {}
+  const canonicalServers =
+    canonical.mcpServers && typeof canonical.mcpServers === 'object' ? canonical.mcpServers : {}
+  const legacyServers =
+    legacy.mcpServers && typeof legacy.mcpServers === 'object' ? legacy.mcpServers : {}
+
+  const config = {
+    ...legacy,
+    ...canonical,
+    mcpServers: {
+      ...legacyServers,
+      ...canonicalServers,
+    },
+  }
+
+  // No project/workspace here: the MCP server derives the project from its own
+  // git cwd. A baked value from install-time cwd overrides that derivation and
+  // mis-attributes every memory write for the host's lifetime.
+  const context = JSON.stringify({
+    agentId: 'workbuddy',
+    sessionId: 'workbuddy-session',
+  })
+
+  config.mcpServers = {
+    ...config.mcpServers,
+    'mio-intelligence': {
+      command: node,
+      args: [serverScript],
+      env: {
+        MIO_DATA_DIR: home,
+        MIO_CONTEXT: context,
+      },
+    },
+  }
+
+  writeApproval('mio-intelligence', config.mcpServers['mio-intelligence'])
+
+  const backup = `${target}.bak-mio-${Date.now()}`
+  if (fs.existsSync(target)) {
+    fs.copyFileSync(target, backup)
+  }
+
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.writeFileSync(target, `${JSON.stringify(config, null, 2)}\n`, 'utf8')
+
+  const userRules = ensureBlock(memoryRulesPath())
+  let projectRules = null
+  const workspaceDir = workspace || process.cwd()
+  if (workspaceDir && path.isAbsolute(workspaceDir)) {
+    projectRules = ensureBlock(projectInstructionsPath(workspaceDir))
+  }
+
+  const changed = userRules.changed || Boolean(projectRules && projectRules.changed)
+
+  return {
+    changed,
+    configPath: target,
+    approvalsPath: approvalsPath(),
+    memoryRulesPath: userRules.target,
+    projectInstructionsPath: projectRules ? projectRules.target : null,
+    userRulesChanged: userRules.changed,
+    projectRulesChanged: projectRules ? projectRules.changed : false,
+    backup,
+    message: 'WorkBuddy Mio MCP installed, approved, and Mio rules injected into CODEBUDDY.md (auto-loaded user memory) and the workspace AGENTS.md. Restart WorkBuddy to load them.',
+  }
+}
+
+module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install }

package/bin/mio.js

@@ -23,10 +23,10 @@ const { createEvolutionCutoverTools } = require('../server/evolution-cutover.js'
 const { createMemoryStore } = require('../server/memory-store.js')
 const { createExperienceStore } = require('../server/experience-store.js')
 const { createPolicyStore } = require('../server/policy-store.js')
-const { CreativityEngine } = require('../server/creativity-engine.js')
+const { CreativityEngine, sourcesFromInsights } = require('../server/creativity-engine.js')
 const { createAgentStore } = require('../server/agent-store.js')
 const { createEvaluationStore } = require('../server/evaluation-store.js')
-const { createInsightStore } = require('../server/insight-store.js')
+const { createInsightStore, isInsightAvailable } = require('../server/insight-store.js')
 const { createObserverStore, isObserverAvailable } = require('../server/observer-store.js')
 const { loadPhase0, renderPhase0Markdown } = require('../server/mio-intelligence-mcp/phase0.js')
 const { listHostCapabilities } = require('../server/host-capabilities.js')
@@ -564,7 +564,9 @@ function digestCommand(args, useJson) {
     let state = {}
     try {
       state = JSON.parse(fs.readFileSync(stateFile, 'utf8'))
-    } catch (_) {}
+    } catch (err) {
+      throw new Error(`Failed to parse ${stateFile}: ${err.message}`)
+    }
     state.contexts = state.contexts || {}
     const stamp = new Date().toLocaleString('zh-CN', { hour12: false })
 
@@ -595,6 +597,7 @@ function digestCommand(args, useJson) {
     }
 
     let written = 0
+    const writeBackFailures = []
     for (const cwd of targetCwds) {
       const line = projectLine.get(path.basename(cwd).toLowerCase())
       if (!line) continue
@@ -602,13 +605,18 @@ function digestCommand(args, useJson) {
         observer.updateProjectContext(state, cwd, stamp + ' | ' + line, 'CLAUDE.md')
         observer.updateProjectContext(state, cwd, stamp + ' | ' + line, 'AGENTS.md')
         written += 1
-      } catch (_) {}
+      } catch (err) {
+        const wsName = path.basename(cwd)
+        console.error(`Write-back failed for ${wsName}:`, err.message || err)
+        writeBackFailures.push({ workspace: wsName, error: err.message || String(err) })
+      }
     }
     fs.mkdirSync(MIO_HOME, { recursive: true })
     fs.writeFileSync(stateFile, JSON.stringify(state) + '\n', 'utf8')
     report.writeBack = {
       workspaces: written,
       skipped: Object.keys(state.contexts).length - written,
+      failures: writeBackFailures,
       projects: [...projectLine.values()],
     }
   }
@@ -626,6 +634,10 @@ function digestCommand(args, useJson) {
     console.log(
       `Write-back: ${report.writeBack.workspaces} workspace(s), ${report.writeBack.skipped} skipped (no digest data)`,
     )
+    if (report.writeBack.failures && report.writeBack.failures.length > 0) {
+      console.error(`  ${report.writeBack.failures.length} write-back failure(s):`)
+      for (const f of report.writeBack.failures) console.error(`    - ${f.workspace}: ${f.error}`)
+    }
     for (const line of report.writeBack.projects) console.log(`  - ${line}`)
   }
 }
@@ -2060,8 +2072,9 @@ function creativityUsage(write = console.log) {
 
 Options:
   --status name      Filter list by status
-  --limit N          Max results for list / ferment (default 20 / 5)
+  --limit N          Max results for list / ferment (default 20 / 5); --limit 0 lists everything
   --source "name|content"   A concept source for generate; repeat 2+ times
+  --from-insights    Seed generate's sources from stored insights (needs @akemi-mio/insight)
   --strategy explore|signal|stable   Generation strategy (auto-selected if omitted)
   --json             Machine-readable output (same shape as the mio.creativity.* tools)
 
@@ -2069,6 +2082,7 @@ Examples:
   mio creativity status
   mio creativity list --status rejected --limit 10
   mio creativity generate --source "auth|token rotation" --source "cache|write-through"
+  mio creativity generate --from-insights --source "auth|token rotation"
 
 generate/ferment call an LLM using the shared client. Configure it with
 LLM_API_URL / LLM_KEY / LLM_CHAT_MODEL (the same environment the MCP server
@@ -2079,7 +2093,7 @@ reads). A local Ollama works:
 function printCreativityStatus(result) {
   console.log('Creativity engine:')
   console.log(`  hypotheses: ${result.hypotheses}  combos: ${result.combos}  experiments: ${result.experiments}`)
-  console.log(`  active: ${result.active}  validated: ${result.validated}  rejected: ${result.rejected}`)
+  console.log(`  active: ${result.active}  validated: ${result.validated}  rejected: ${result.rejected}  draft: ${result.draft}`)
   if (result.recentIdeas.length === 0) {
     console.log('No hypotheses yet.')
     return
@@ -2136,12 +2150,56 @@ function warnIfLlmUnconfigured() {
   console.log('(or set LLM_API_URL / LLM_KEY / LLM_CHAT_MODEL in the environment)')
 }
 
+// Failed LLM calls used to disappear: `generate` swallowed them and `ferment`
+// reported "Nothing fermented", so a dead endpoint looked exactly like "no new
+// ideas". Both now surface them; the JSON shapes carry `errors` as well.
+function printCreativityErrors(errors, label) {
+  if (!Array.isArray(errors) || errors.length === 0) return
+  console.log(`\n${errors.length} ${label}(s) failed:`)
+  for (const err of errors) {
+    const who = err.pair ? err.pair.join(' + ') : (err.title || err.id)
+    console.log(`- ${who}: ${err.error}`)
+  }
+}
+
 function creativityGenerateCommand(args, useJson) {
   const flags = args.slice(2)
-  const sources = parseSources(flags)
+  let sources = parseSources(flags)
+
+  // `--from-insights` seeds the mixer with whatever the insight engine has
+  // already noticed. It reads the *CLI's* store (global MIO_HOME), the same
+  // one `mio insight list` shows, and merges with any explicit --source.
+  if (flagPresent(flags, '--from-insights')) {
+    if (!isInsightAvailable()) {
+      console.error('mio creativity generate --from-insights requires the optional package @akemi-mio/insight')
+      process.exitCode = 1
+      return
+    }
+    let seeds
+    try {
+      seeds = sourcesFromInsights(cliInsightStore().list({}))
+    } catch (error) {
+      console.error(error.message || error)
+      process.exitCode = 1
+      return
+    }
+    if (seeds.length === 0) {
+      console.error('mio creativity generate --from-insights: no stored insights yet (run `mio insight generate` first)')
+      process.exitCode = 1
+      return
+    }
+    sources = sources.concat(seeds)
+  }
+
   if (sources.length < 2) {
-    console.error('mio creativity generate requires at least two --source "name|content" arguments')
-    console.error('Example: mio creativity generate --source "auth|token rotation" --source "cache|write-through cache"')
+    if (flagPresent(flags, '--from-insights')) {
+      console.error(`mio creativity generate needs at least 2 concept sources; --from-insights only supplied ${sources.length}.`)
+      console.error('Add more --source "name|content" arguments, or generate more insights first.')
+    } else {
+      console.error('mio creativity generate requires at least two --source "name|content" arguments')
+      console.error('Example: mio creativity generate --source "auth|token rotation" --source "cache|write-through cache"')
+      console.error('Or seed them with --from-insights (uses stored insights as concepts).')
+    }
     process.exitCode = 1
     return
   }
@@ -2170,6 +2228,7 @@ function creativityGenerateCommand(args, useJson) {
       console.log(`   novelty=${idea.novelty} feasibility=${idea.feasibility} impact=${idea.impact} | ${idea.id}`)
       if (idea.rejectionReason) console.log(`   rejected: ${idea.rejectionReason}`)
     })
+    printCreativityErrors(resolved.errors, 'pair')
   })
 }
 
@@ -2191,12 +2250,16 @@ function creativityFermentCommand(args, useJson) {
     if (useJson) return jsonOrText(resolved, true)
     if (resolved.fermented === 0) {
       console.log(`Nothing fermented: ${resolved.reason || 'no eligible hypotheses'}`)
+      // Every review can fail while there was something to review; without
+      // this the endpoint outage read as "the store is empty".
+      printCreativityErrors(resolved.errors, 'review')
       return
     }
     console.log(`Fermented ${resolved.fermented} hypothesis/hypotheses`)
     for (const r of resolved.results || []) {
       console.log(`- ${r.title || r.id}: ${r.verdict || 'updated'}${r.reason ? ` — ${r.reason}` : ''}`)
     }
+    printCreativityErrors(resolved.errors, 'review')
   })
 }
 
@@ -3136,22 +3199,33 @@ function installCommand(host, useJson) {
     }
     writeConfig(config)
   }
+  let observerCycleOk = true
   try {
     observer.runCycle(MIO_HOME, observer.loadState(MIO_HOME), observer.createSinks(MIO_HOME))
-  } catch (_) {}
+  } catch (err) {
+    console.error('Observer cycle failed during install:', err.message || err)
+    observerCycleOk = false
+  }
   let observerStarted = false
   try {
     observerStarted = observer.startBackground(MIO_HOME).started
-  } catch (_) {}
+  } catch (err) {
+    console.error('Observer background startup failed during install:', err.message || err)
+    observerStarted = false
+  }
   if (useJson) {
     result.observer = {
       running: observer.isRunning(MIO_HOME),
       started: observerStarted,
+      cycleOk: observerCycleOk,
     }
     jsonOrText(result, true)
     return
   }
   console.log(result.message || `${host} adapter completed.`)
+  if (!observerCycleOk) {
+    console.error('Warning: observer cycle failed during install; run `mio observe --once` manually.')
+  }
   console.log(
     observer.isRunning(MIO_HOME)
       ? 'Observer daemon running.'
@@ -3160,6 +3234,13 @@ function installCommand(host, useJson) {
 }
 
 function mcpCommand() {
+  // The MCP server resolves its data dir as `MIO_DATA_DIR || <cwd>/.mio-intelligence`,
+  // while every CLI subcommand reads the global MIO_HOME. Left alone, `mio mcp`
+  // launched from a scratch directory built a second, empty store there and
+  // `mio.creativity.list` / `mio.recall` disagreed with `mio creativity list` /
+  // `mio recall`. Pinning it makes the stdio server see the same data as the
+  // terminal; an explicit MIO_DATA_DIR still wins (adapters set one on purpose).
+  if (!process.env.MIO_DATA_DIR) process.env.MIO_DATA_DIR = MIO_HOME
   require(SERVER_SCRIPT)
 }
 
@@ -3289,7 +3370,7 @@ Usage:
   mio experience reuse --source-agent A --target-agent B --experience-id X   Record a reuse
   mio creativity status        Show creativity hypothesis counts and recent top ideas
   mio creativity list          List creativity hypotheses (--status active|validated|rejected|draft, --limit N)
-  mio creativity generate      Generate hypotheses from 2+ --source "name|content" (calls an LLM)
+  mio creativity generate      Generate hypotheses from 2+ --source "name|content" (or --from-insights; calls an LLM)
   mio creativity ferment       Review and refine active hypotheses (calls an LLM)
   mio insight status           Insight counts: total, reported, unreported, high-value
   mio insight list             List insights (--unreported, --min-score N, --detector X, --limit N)