mio-agent-runtime 0.3.0 → 0.3.2

package/README.md

@@ -1,73 +1,79 @@
-# mio-agent-runtime
-
-Mio Agent Runtime 的可发布 CLI 包。
-
-安装一次，所有 Agent 自动接入 Mio。
-
-## Install
-
-```bash
-npm install -g mio-agent-runtime
-```
-
-## Commands
-
-```text
-mio init                    Initialize MIO_HOME
-mio mcp                     Start Mio MCP server (stdio)
-mio install <host>          Install Mio into a host (codex|opencode|workbuddy)
-mio status                  Show runtime and adapter status
-mio agents                  List installed agents
-mio observe                 Watch WorkBuddy transcripts and auto-ingest task outcomes (foreground)
-mio observe --start|--stop|--status|--once   Manage the background observer daemon
-mio --json status           Machine-readable status
-mio --json agents           Machine-readable agents
-```
-
-## Host notes
-
-- OpenCode uses `~/.config/opencode/opencode.json` for MCP registration and
-  `~/.config/opencode/AGENTS.md` for global instructions. `mio install opencode`
-  writes both files and injects Mio usage rules into `AGENTS.md` so OpenCode
-  calls Mio memory/observer/policy automatically. If OpenCode is already
-  running, restart it once so it reloads both files.
-- WorkBuddy uses `~/.workbuddy/mcp.json` and requires each custom MCP server to
-  be approved in `~/.workbuddy/mcp-approvals.json`. `mio install workbuddy`
-  writes both files and injects Mio usage rules into
-  `~/.workbuddy/CODEBUDDY.md` (user-level memory rules, auto-loaded by
-  WorkBuddy into every session; the CLI hardcodes the CodeBuddy product name, so the file is CODEBUDDY.md not WORKBUDDY.md) plus `<workspace>/AGENTS.md` (project-level).
-  If WorkBuddy is already running, restart it once so it reloads the approval
-  and memory rule files.
-
-## Passive observer (`mio observe`)
-
-WorkBuddy 的默认模型不一定会主动调用 Mio MCP 工具，即使规则已注入
-(`CODEBUDDY.md` / `AGENTS.md`)。`mio observe` 是一个不依赖模型自觉的
-兜底：它持续监听 `~/.workbuddy/projects/**/*.jsonl` 会话记录，把每个任务的
-结果（`task_outcome`）、工具调用错误（`error`）以及完成任务的摘要自动写入
-`MIO_HOME/traces.jsonl` 和 `MIO_HOME/memory.jsonl`（与 MCP 服务同一套
-schema，`source=workbuddy-observer`）。
-
-- `mio install <host>` 会自动执行一次回填并启动后台观察器。
-- 已处理的文件偏移记录在 `MIO_HOME/observe-state.json`，不会重复写入。
-- 只回填最近 24h 内更新的会话，避免把历史记录灌入记忆库。
-
-## MIO_HOME
-
-默认 `~/.mio-intelligence`，可通过环境变量 `MIO_HOME` 覆盖。
-
-## Package layout
-
-```text
-packages/mio-cli
-├── bin/mio.js
-├── adapters/
-│   ├── codex.js
-│   ├── opencode.js
-│   └── workbuddy.js
-├── observe/
-│   └── observer.js
-├── server/
-│   └── mio-intelligence-mcp/index.js
-└── package.json
+# mio-agent-runtime
+
+Mio Agent Runtime 的可发布 CLI 包。
+
+安装一次，所有 Agent 自动接入 Mio。
+
+## Install
+
+```bash
+npm install -g mio-agent-runtime
+```
+
+## Commands
+
+```text
+mio init                    Initialize MIO_HOME
+mio mcp                     Start Mio MCP server (stdio)
+mio install <host>          Install Mio into a host (codex|opencode|workbuddy)
+mio status                  Show runtime and adapter status
+mio agents                  List installed agents
+mio observe                 Watch WorkBuddy transcripts and auto-ingest task outcomes (foreground)
+mio observe --start|--stop|--status|--once   Manage the background observer daemon
+mio --json status           Machine-readable status
+mio --json agents           Machine-readable agents
+```
+
+## Host notes
+
+- OpenCode uses `~/.config/opencode/opencode.json` for MCP registration and
+  `~/.config/opencode/AGENTS.md` for global instructions. `mio install opencode`
+  writes both files and injects Mio usage rules into `AGENTS.md` so OpenCode
+  calls Mio memory/observer/policy automatically. If OpenCode is already
+  running, restart it once so it reloads both files.
+- WorkBuddy uses `~/.workbuddy/mcp.json` and requires each custom MCP server to
+  be approved in `~/.workbuddy/mcp-approvals.json`. `mio install workbuddy`
+  writes both files and injects Mio usage rules into
+  `~/.workbuddy/CODEBUDDY.md` (user-level memory rules, auto-loaded by
+  WorkBuddy into every session; the CLI hardcodes the CodeBuddy product name, so the file is CODEBUDDY.md not WORKBUDDY.md) plus `<workspace>/AGENTS.md` (project-level).
+  If WorkBuddy is already running, restart it once so it reloads the approval
+  and memory rule files.
+
+## Passive observer (`mio observe`)
+
+WorkBuddy 的默认模型不一定会主动调用 Mio MCP 工具，即使规则已注入
+(`CODEBUDDY.md` / `AGENTS.md`)。`mio observe` 是一个不依赖模型自觉的
+兜底：它持续监听 `~/.workbuddy/projects/**/*.jsonl` 会话记录，把每个任务的
+结果（`task_outcome`）、工具调用错误（`error`）以及完成任务的摘要自动写入
+`MIO_HOME/traces.jsonl` 和 `MIO_HOME/memory.jsonl`（与 MCP 服务同一套
+schema，`source=workbuddy-observer`）。
+
+- `mio install <host>` 会自动执行一次回填并启动后台观察器。
+
+- 除了写入 `MIO_HOME`，观察器还会把任务摘要**写回 WorkBuddy 自己的记忆文件**
+  (`<workspace>/.workbuddy/memory/YYYY-MM-DD.md`，标为 `## Mio 自动摘要`)。
+  WorkBuddy 的系统提示要求模型每次会话维护并阅读这些文件，所以下一次会话
+  WorkBuddy 会**被动取到** Mio 记录的内容——单 Agent 的「存 + 取」闭环不依赖
+  模型调用 Mio 工具。
+- 已处理的文件偏移记录在 `MIO_HOME/observe-state.json`，不会重复写入。
+- 只回填最近 24h 内更新的会话，避免把历史记录灌入记忆库。
+
+## MIO_HOME
+
+默认 `~/.mio-intelligence`，可通过环境变量 `MIO_HOME` 覆盖。
+
+## Package layout
+
+```text
+packages/mio-cli
+├── bin/mio.js
+├── adapters/
+│   ├── codex.js
+│   ├── opencode.js
+│   └── workbuddy.js
+├── observe/
+│   └── observer.js
+├── server/
+│   └── mio-intelligence-mcp/index.js
+└── package.json
 ```

package/observe/observer.js

@@ -74,10 +74,11 @@ function loadState(home) {
         files: parsed.files || {},
         buffers: parsed.buffers || {},
         openTurns: parsed.openTurns || {},
+        contexts: parsed.contexts || {},
       }
     }
   } catch (_) {}
-  return { version: 1, files: {}, buffers: {}, openTurns: {} }
+  return { version: 1, files: {}, buffers: {}, openTurns: {}, contexts: {} }
 }
 
 function saveState(home, state) {
@@ -178,6 +179,7 @@ function createTurn(meta) {
     ts: null,
     project: meta.project,
     sessionId: meta.sessionId,
+    cwd: meta.cwd || null,
     toolCount: 0,
     errors: [],
     lastAssistant: null,
@@ -187,12 +189,14 @@ function createTurn(meta) {
 function feedWorkbuddyLine(turn, obj) {
   if (!obj || typeof obj !== 'object') return { finalized: null, next: turn }
   let finalized = null
+  if (obj.cwd) turn.cwd = obj.cwd
   if (obj.type === 'message') {
     if (obj.role === 'user') {
       finalized = turn
       const next = createTurn(turn)
       next.id = obj.id
       next.ts = obj.timestamp
+      next.cwd = obj.cwd || turn.cwd
       return { finalized, next: next }
     }
     if (obj.role === 'assistant') {
@@ -218,9 +222,63 @@ function feedWorkbuddyLine(turn, obj) {
   return { finalized: finalized, next: turn }
 }
 
-function emitWorkbuddyOutcome(turn, sinks) {
+const CONTEXT_BEGIN = '<!-- MIO_CONTEXT_BEGIN -->'
+const CONTEXT_END = '<!-- MIO_CONTEXT_END -->'
+const CONTEXT_MAX = 6
+
+// Maintain a compact 'recent Mio context' block inside <workspace>/AGENTS.md,
+// which WorkBuddy's MemoryLoader auto-injects into every session. This makes
+// retrieval guaranteed (not dependent on the model deciding to read memory).
+function updateProjectContext(state, cwd, line) {
+  if (!cwd || !line) return
+  const target = path.join(cwd, 'AGENTS.md')
+  const list = state.contexts[cwd] || []
+  list.unshift(line)
+  if (list.length > CONTEXT_MAX) list.pop()
+  state.contexts[cwd] = list
+  try {
+    let content = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
+    const block = CONTEXT_BEGIN + '\n## Mio 最近上下文（自动注入）\n' + list.map(function (l) { return '- ' + l }).join('\n') + '\n' + CONTEXT_END
+    const start = content.indexOf(CONTEXT_BEGIN)
+    if (start !== -1) {
+      const end = content.indexOf(CONTEXT_END, start)
+      content = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + CONTEXT_END.length)
+    }
+    content = content.trimEnd() + '\n\n' + block + '\n'
+    fs.mkdirSync(path.dirname(target), { recursive: true })
+    fs.writeFileSync(target, content, 'utf8')
+  } catch (_) {}
+}
+
+function localDateKey(ts) {
+  const d = new Date(Number(ts) || Date.now())
+  const y = d.getFullYear()
+  const m = String(d.getMonth() + 1).padStart(2, '0')
+  const day = String(d.getDate()).padStart(2, '0')
+  return y + '-' + m + '-' + day
+}
+
+// Write a compact Mio digest back into WorkBuddy's own memory file
+// (<workspace>/.workbuddy/memory/YYYY-MM-DD.md). WorkBuddy instructs its model
+// to maintain and read these files every session, so the digest is
+// 'retrieved' next session without any Mio tool call by the model.
+function writeWorkbuddyDigest(turn, outcome, summary) {
+  if (!turn.cwd || !summary) return
+  const dir = path.join(turn.cwd, '.workbuddy', 'memory')
+  const file = path.join(dir, localDateKey(turn.ts) + '.md')
+  try {
+    fs.mkdirSync(dir, { recursive: true })
+    const time = new Date(Number(turn.ts) || Date.now()).toLocaleString('zh-CN', { hour12: false })
+    const entry =
+      '\n## Mio 自动摘要 (' + time + ')\n' +
+      '- outcome: ' + outcome + ' | tools: ' + turn.toolCount + ' | ' + summary.slice(0, 160) + '\n'
+    fs.appendFileSync(file, entry, 'utf8')
+  } catch (_) {}
+}
+
+function emitWorkbuddyOutcome(turn, sinks, state) {
   const la = turn.lastAssistant
-  if (!la) return
+  if (!la) return false
   let outcome
   if (la.status === 'completed') outcome = 'success'
   else if (la.error) outcome = 'failure'
@@ -248,7 +306,10 @@ function emitWorkbuddyOutcome(turn, sinks) {
     project: turn.project,
   })
 
-  if (outcome === 'success' && summary.length >= 40) {
+  // Low threshold: even a short but real completion summary must reach the
+  // passive retrieval paths (memory + daily digest + AGENTS.md context block).
+  // 40 was too strict and silently dropped short summaries from retrieval.
+  if (outcome === 'success' && summary.length >= 10) {
     sinks.memory({
       kind: 'note',
       content: '[workbuddy] 任务完成: ' + summary.slice(0, 160),
@@ -256,6 +317,9 @@ function emitWorkbuddyOutcome(turn, sinks) {
       project: turn.project,
       source: 'workbuddy-observer',
     })
+    writeWorkbuddyDigest(turn, outcome, summary)
+    var ctxTime = new Date(Number(turn.ts) || Date.now()).toLocaleString('zh-CN', { hour12: false })
+    updateProjectContext(state, turn.cwd, ctxTime + ' | ' + outcome + ' | ' + summary.slice(0, 80))
   }
 
   for (const err of turn.errors) {
@@ -276,6 +340,7 @@ function emitWorkbuddyOutcome(turn, sinks) {
       project: turn.project,
     })
   }
+  return true
 }
 
 // ---------------------------------------------------------------------------
@@ -338,8 +403,7 @@ function runCycle(home, state, sinks, opts) {
         }
         const result = feedWorkbuddyLine(turn, obj)
         if (result.finalized) {
-          emitWorkbuddyOutcome(result.finalized, sinks)
-          out.outcomes += 1
+          if (emitWorkbuddyOutcome(result.finalized, sinks, state)) out.outcomes += 1
         }
         turn = result.next
       }
@@ -347,8 +411,7 @@ function runCycle(home, state, sinks, opts) {
     }
 
     if (turn.lastAssistant && now - st.mtimeMs > IDLE_MS) {
-      emitWorkbuddyOutcome(turn, sinks)
-      out.outcomes += 1
+      if (emitWorkbuddyOutcome(turn, sinks, state)) out.outcomes += 1
       state.openTurns[file] = null
     } else if (turn.id) {
       state.openTurns[file] = turn

package/package.json

@@ -1,24 +1,24 @@
-{
-  "name": "mio-agent-runtime",
-  "version": "0.3.0",
-  "description": "Mio Agent Runtime installer and MCP intelligence layer",
-  "license": "MIT",
-  "type": "commonjs",
-  "bin": {
-    "mio": "bin/mio.js"
-  },
-  "files": [
-    "bin/",
-    "server/",
-    "adapters/",
-    "observe/",
-    "README.md"
-  ],
-  "scripts": {
-    "check": "node --check bin/mio.js && node --check adapters/codex.js && node --check adapters/opencode.js && node --check adapters/workbuddy.js && node --check server/mio-intelligence-mcp/index.js && node --check observe/observer.js",
-    "prepack": "npm run check"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "mio-agent-runtime",
+  "version": "0.3.2",
+  "description": "Mio Agent Runtime installer and MCP intelligence layer",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "mio": "bin/mio.js"
+  },
+  "files": [
+    "bin/",
+    "server/",
+    "adapters/",
+    "observe/",
+    "README.md"
+  ],
+  "scripts": {
+    "check": "node --check bin/mio.js && node --check adapters/codex.js && node --check adapters/opencode.js && node --check adapters/workbuddy.js && node --check server/mio-intelligence-mcp/index.js && node --check observe/observer.js",
+    "prepack": "npm run check"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}