mio-agent-runtime 0.13.3 → 0.13.5

package/README.md

@@ -55,7 +55,7 @@ mio memory migrate --ids a,b --scope global|project   Move records between the p
 mio policy check "<action>" Check the historical risk of an action before running it (--project; reads global MIO_HOME)
 mio creativity status        Show creativity hypothesis counts and recent top ideas (reads global MIO_HOME)
 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 (needs @akemi-mio/insight)
 mio insight list             List insights (--unreported, --min-score N, --detector X, --limit N)
@@ -359,7 +359,7 @@ Historically risky: ...
 
 说明：
 
-- **它读取全局 `MIO_HOME`，而非每项目目录。** MCP 服务端把数据目录解析为 `MIO_DATA_DIR || cwd/.mio-intelligence`，因此从任意目录发起的 MCP 调用看到的是空存储；CLI 刻意指向累积的全局日志。用 `--project` 把 trace 集合限定到某个项目。
+- **它读取全局 `MIO_HOME`，而非每项目目录。** MCP 服务端把数据目录解析为 `MIO_DATA_DIR || cwd/.mio-intelligence`，因此从任意目录发起的 MCP 调用看到的是空存储；CLI 刻意指向累积的全局日志。`mio mcp` 是例外：它先把 `MIO_DATA_DIR` 钉到 `MIO_HOME` 再启动服务端，于是 stdio 入口与终端读写同一份数据。注意：各桌面宿主适配器（codex、opencode、workbuddy、hermes、claude-code）在启动 MCP 服务端时会**显式传入**各自的 `MIO_DATA_DIR`（指向宿主的配置目录），因此它们**不共享** CLI 的 `MIO_HOME`；只有 `mio mcp`（直接 stdio 连接）才与终端读写同一份数据。用 `--project` 把 trace 集合限定到某个项目。
 - **风险即失败占比**，`>= 0.4` 为高，`>= 0.2` 为中。`retry` 与 `aborted` 与 `failure`、`error` 一并计为失败。无匹配历史报告 `UNKNOWN`，与 `LOW`（干净记录）不同。
 - **匹配可能被通用 token 带偏。** 匹配是对动作 token 的宽松 OR，所以像 `task` 这样的动作几乎匹配每条 trace，因为关键词 `task` 几乎出现在所有 payload 中。当动作中*每个* token 都至少出现在半数候选 trace 里时，CLI 会打印警告，而不是让等级自说自话：
 
@@ -386,7 +386,7 @@ mio creativity list --json
 ```text
 Creativity engine:
   hypotheses: 5  combos: 3  experiments: 1
-  active: 2  validated: 1  rejected: 1
+  active: 2  validated: 1  rejected: 1  draft: 1
 
 Recent top ideas:
 - Plugin architecture  (novelty=80 feasibility=70 impact=90 score=240)
@@ -396,7 +396,10 @@ Recent top ideas:
 说明：
 
 - **它委托给与 MCP 服务端相同的 `CreativityEngine`**，因此终端的 `mio creativity list` 看到的是与 `mio.creativity.list` 工具完全一致的假设。存储位于 `<MIO_HOME>/creativity/creativity-hypotheses.jsonl`；CLI 指向全局 `MIO_HOME`，与 `mio policy check` 一致。
+- **`list` 默认只返回最新 20 条**，与 `mio.creativity.list` 的 schema 承诺一致；`--limit 0`（或 MCP 的 `limit: 0`）才是「全部」。存储很大时默认全量返回会把工具结果撑爆。
+- **`status` 计入 `draft`。** `draft` 是发酵中的真实状态（`ferment` 会同时处理 `draft` 与 `active`），此前漏计导致 `status` 与 `list --status draft` 对不上。
 - **空存储是正常状态。** 引擎运行之前，`status` 报告全零计数，`list` 显示 "No hypotheses match." 两者都是有效输出，不是错误。
+- **缓存会在文件变化时失效。** 三个 JSONL 的读取按 `(size, mtime)` 校验，因此另一个进程写入后长驻的 MCP 服务端无需重启就能看到——与 `server/insight-store.js` 同一套守卫。
 
 ### 生成与发酵（`generate` / `ferment`）
 
@@ -405,14 +408,25 @@ Recent top ideas:
 
 ```bash
 mio creativity generate --source "auth|token rotation" --source "cache|write-through"
+mio creativity generate --from-insights --source "auth|token rotation"
 mio creativity ferment --limit 3
 ```
 
 - `--source "名称|内容"` **至少两个**：引擎是把概念两两配对来产生新假设的，
   一个来源在构造上就不可能产出组合（此时**不会**调用 LLM，直接返回
   `need at least 2 sources`）。
-- `ferment` 会复核 `active` 假设并更新分数；`verdict=promote` 且总分 > 200 时
+- **`--from-insights`（MCP 侧为 `fromInsights: true`）用已存洞察补足概念来源**：
+  读取 `mio insight list` 能看到的同一份存储，按分数取前 10 条映射成
+  `{ name, content, type: 'insight' }`，再与显式的 `--source` 合并。它只在
+  `@akemi-mio/insight` 已安装且至少存有一条洞察时有意义，否则明确报错而不是
+  静默当作「没有来源」。因为来源可由它提供，`mio.creativity.generate` 的
+  `sources` 不再是 schema 必填项。
+- `ferment` 会复核 `active` / `draft` 假设并更新分数；`verdict=promote` 且总分 > 200 时
   升为 `validated`，`verdict=reject` 则标记为 `rejected`。
+- **失败的 LLM 调用会出现在结果里，不再被吞掉。** 返回值带 `errors`
+  （`generate` 是 `pair` + 原因，`ferment` 是 `id` + 原因），CLI 也会在正文后
+  打印 `N pair(s) failed:`。此前 `catch {}` 让「端点挂了」与「这一对确实没有
+  新意」长得一模一样——`ideas: []` / `Nothing fermented` 两种输出都无法区分。
 
 #### LLM 配置
 
@@ -491,7 +505,7 @@ mio observer trends --base-dir /path/to/.local/observer
   mio observer ferment --session morning                # morning|afternoon|night
   ```
 
-  两者都依赖可选包 `@akemi-mio/observer`（未安装时提示 `not installed`，不是空结果）。`collect` 会**联网**抓取，`ferment` 需要 LLM；它们**不做预览**，因为预览意味着把数据抓两遍。单个源失败不会中断整次运行——该源会以 `errors: ...` 出现在输出里，其余源照常统计。
+  两者都依赖可选包 `@akemi-mio/observer`（未安装时提示 `not installed`，不是空结果）。`collect` 会**联网**抓取，`ferment` 需要 LLM；它们**不做预览**，因为预览意味着把数据抓两遍。单个源失败不会中断整次运行——该源会以 `errors: ...` 出现在输出里，其余源照常统计。`collect` 会**联网**抓取，`ferment` 需要 LLM；它们**不做预览**，因为预览意味着把数据抓两遍。单个源失败不会中断整次运行——该源会以 `errors: ...` 出现在输出里，其余源照常统计。
 - **`mio observer pipeline` 是研究 DAG 的入口**（`collect → trend → tension → research → multi-brain → compose → world model → publish → self-evolve`）。此前 `runPipeline` / `tickPipeline` / `forcePipeline` 在 mio-agent-runtime 里**没有任何调用方**，所以 trends / research / insights 默认永远是空的，只有手动实例化服务才能跑通。它同样依赖 `@akemi-mio/observer`，会**联网并调用多次 LLM**，因此和 `subscribe` 一样**默认只预览**（读今天的 DAG 状态与解析后的 LLM 端点，不构造服务、不建目录），`--run` 才真正执行：
 
   ```bash

package/adapters/claude-code.js

@@ -46,12 +46,12 @@ const MEMORY_BLOCK = `${MEMORY_BEGIN}
 
 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\`.
+- 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}`

package/adapters/codex.js

@@ -1,122 +1,122 @@
-'use strict'
-
-const fs = require('fs')
-const path = require('path')
-const os = require('os')
-const { restartWarning } = require('./host-utils')
-
-const SERVER_SECTION = '[mcp_servers.mio-intelligence]'
-const ENV_SECTION = '[mcp_servers.mio-intelligence.env]'
-
-function configPath() {
-  return path.join(os.homedir(), '.codex', 'config.toml')
-}
-
-function isInstalled() {
-  const target = configPath()
-  if (!fs.existsSync(target)) return false
-  return fs.readFileSync(target, 'utf8').includes(SERVER_SECTION)
-}
-
-// Legacy installs pointed args at the worktree copy of the server
-// (server/mio-intelligence-mcp/index.js) instead of this package's copy
-// (server/mio-intelligence-mcp/index.js). Detect staleness by comparing the
-// configured args path with the server path this package ships.
-function configNeedsRepair(serverScript) {
-  const target = configPath()
-  if (!fs.existsSync(target)) return false
-  try {
-    const src = fs.readFileSync(target, 'utf8')
-    if (!src.includes(SERVER_SECTION)) return false
-    const needle = serverScript.replace(/\\/g, '/').toLowerCase()
-    return !src.replace(/\\/g, '/').toLowerCase().includes(needle)
-  } catch (_) {
-    return false
-  }
-}
-
-function installMessage(installed, restartHint) {
-  let message = installed
-    ? 'Codex Mio MCP repaired (server path updated). Restart Codex to load it.'
-    : 'Codex Mio MCP installed. Restart Codex to load it.'
-  if (restartHint) message += ' ' + restartHint
-  return message
-}
-
-function restartWarningMessage() {
-  return restartWarning({
-    hostLabel: 'Codex',
-    exeName: 'codex.exe',
-    exePathFragment: 'OpenAI.Codex',
-    configPath: configPath(),
-  })
-}
-
-function stripMioSection(toml) {
-  const lines = toml.replace(/\r\n/g, '\n').split('\n')
-  const out = []
-  let skipping = false
-  for (const line of lines) {
-    const trimmed = line.trim()
-    if (trimmed === SERVER_SECTION || trimmed === ENV_SECTION) {
-      skipping = true
-      continue
-    }
-    if (skipping && /^\[.*\]$/.test(trimmed)) {
-      skipping = false
-    }
-    if (!skipping) out.push(line)
-  }
-  return out.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n'
-}
-
-function install({ node, serverScript, home, workspace }) {
-  const target = configPath()
-  const backup = `${target}.bak-mio-${Date.now()}`
-  const installed = isInstalled()
-  if (installed && !configNeedsRepair(serverScript)) {
-    return {
-      changed: false,
-      configPath: target,
-      message: 'Codex Mio MCP already installed.',
-    }
-  }
-
-  if (fs.existsSync(target)) {
-    fs.copyFileSync(target, backup)
-  }
-
-  const context = JSON.stringify({
-    agentId: 'codex',
-    workspace: workspace || process.cwd(),
-    sessionId: 'codex-session',
-  })
-
-  fs.mkdirSync(path.dirname(target), { recursive: true })
-  let toml = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
-  toml = stripMioSection(toml)
-  toml = toml.replace(/\n{3,}/g, '\n\n')
-  if (!toml.endsWith('\n')) toml += '\n'
-  const section = [
-    '',
-    SERVER_SECTION,
-    `command = '${node}'`,
-    `args = ['${serverScript}']`,
-    'startup_timeout_sec = 30',
-    '',
-    ENV_SECTION,
-    `MIO_DATA_DIR = '${home}'`,
-    `MIO_CONTEXT = '${context}'`,
-    '',
-  ].join('\n')
-  fs.writeFileSync(target, `${toml}${section}\n`, 'utf8')
-
-  return {
-    changed: true,
-    configPath: target,
-    backup,
-    message: installMessage(installed, restartWarningMessage()),
-  }
-}
-
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+const { restartWarning } = require('./host-utils')
+
+const SERVER_SECTION = '[mcp_servers.mio-intelligence]'
+const ENV_SECTION = '[mcp_servers.mio-intelligence.env]'
+
+function configPath() {
+  return path.join(os.homedir(), '.codex', 'config.toml')
+}
+
+function isInstalled() {
+  const target = configPath()
+  if (!fs.existsSync(target)) return false
+  return fs.readFileSync(target, 'utf8').includes(SERVER_SECTION)
+}
+
+// Legacy installs pointed args at the worktree copy of the server
+// (server/mio-intelligence-mcp/index.js) instead of this package's copy
+// (server/mio-intelligence-mcp/index.js). Detect staleness by comparing the
+// configured args path with the server path this package ships.
+function configNeedsRepair(serverScript) {
+  const target = configPath()
+  if (!fs.existsSync(target)) return false
+  try {
+    const src = fs.readFileSync(target, 'utf8')
+    if (!src.includes(SERVER_SECTION)) return false
+    const needle = serverScript.replace(/\\/g, '/').toLowerCase()
+    return !src.replace(/\\/g, '/').toLowerCase().includes(needle)
+  } catch (_) {
+    return false
+  }
+}
+
+function installMessage(installed, restartHint) {
+  let message = installed
+    ? 'Codex Mio MCP repaired (server path updated). Restart Codex to load it.'
+    : 'Codex Mio MCP installed. Restart Codex to load it.'
+  if (restartHint) message += ' ' + restartHint
+  return message
+}
+
+function restartWarningMessage() {
+  return restartWarning({
+    hostLabel: 'Codex',
+    exeName: 'codex.exe',
+    exePathFragment: 'OpenAI.Codex',
+    configPath: configPath(),
+  })
+}
+
+function stripMioSection(toml) {
+  const lines = toml.replace(/\r\n/g, '\n').split('\n')
+  const out = []
+  let skipping = false
+  for (const line of lines) {
+    const trimmed = line.trim()
+    if (trimmed === SERVER_SECTION || trimmed === ENV_SECTION) {
+      skipping = true
+      continue
+    }
+    if (skipping && /^\[.*\]$/.test(trimmed)) {
+      skipping = false
+    }
+    if (!skipping) out.push(line)
+  }
+  return out.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n'
+}
+
+function install({ node, serverScript, home, workspace }) {
+  const target = configPath()
+  const backup = `${target}.bak-mio-${Date.now()}`
+  const installed = isInstalled()
+  if (installed && !configNeedsRepair(serverScript)) {
+    return {
+      changed: false,
+      configPath: target,
+      message: 'Codex Mio MCP already installed.',
+    }
+  }
+
+  if (fs.existsSync(target)) {
+    fs.copyFileSync(target, backup)
+  }
+
+  const context = JSON.stringify({
+    agentId: 'codex',
+    workspace: workspace || process.cwd(),
+    sessionId: 'codex-session',
+  })
+
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  let toml = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
+  toml = stripMioSection(toml)
+  toml = toml.replace(/\n{3,}/g, '\n\n')
+  if (!toml.endsWith('\n')) toml += '\n'
+  const section = [
+    '',
+    SERVER_SECTION,
+    `command = '${node}'`,
+    `args = ['${serverScript}']`,
+    'startup_timeout_sec = 30',
+    '',
+    ENV_SECTION,
+    `MIO_DATA_DIR = '${home}'`,
+    `MIO_CONTEXT = '${context}'`,
+    '',
+  ].join('\n')
+  fs.writeFileSync(target, `${toml}${section}\n`, 'utf8')
+
+  return {
+    changed: true,
+    configPath: target,
+    backup,
+    message: installMessage(installed, restartWarningMessage()),
+  }
+}
+
 module.exports = { configPath, isInstalled, install, restartWarningMessage }