mio-agent-runtime 0.3.0 → 0.3.1

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

@@ -178,6 +178,7 @@ function createTurn(meta) {
     ts: null,
     project: meta.project,
     sessionId: meta.sessionId,
+    cwd: meta.cwd || null,
     toolCount: 0,
     errors: [],
     lastAssistant: null,
@@ -187,12 +188,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 +221,35 @@ function feedWorkbuddyLine(turn, obj) {
   return { finalized: finalized, next: turn }
 }
 
+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) {
   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'
@@ -256,6 +285,7 @@ function emitWorkbuddyOutcome(turn, sinks) {
       project: turn.project,
       source: 'workbuddy-observer',
     })
+    writeWorkbuddyDigest(turn, outcome, summary)
   }
 
   for (const err of turn.errors) {
@@ -276,6 +306,7 @@ function emitWorkbuddyOutcome(turn, sinks) {
       project: turn.project,
     })
   }
+  return true
 }
 
 // ---------------------------------------------------------------------------
@@ -338,8 +369,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)) out.outcomes += 1
         }
         turn = result.next
       }
@@ -347,8 +377,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)) out.outcomes += 1
       state.openTurns[file] = null
     } else if (turn.id) {
       state.openTurns[file] = turn

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mio-agent-runtime",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Mio Agent Runtime installer and MCP intelligence layer",
   "license": "MIT",
   "type": "commonjs",