mio-agent-runtime 0.2.1 → 0.2.2

package/README.md

@@ -26,8 +26,9 @@ mio --json agents           Machine-readable agents
 
 - 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. If WorkBuddy is already running, restart it once so it
-  reloads the approval file.
+  writes both files and injects Mio usage rules into `~/.workbuddy/MEMORY.md`
+  so WorkBuddy calls Mio memory/observer/policy automatically. If WorkBuddy is
+  already running, restart it once so it reloads the approval and memory files.
 
 ## MIO_HOME
 

package/adapters/workbuddy.js

@@ -25,6 +25,10 @@ function approvalsPath() {
   return path.join(configDir(), 'mcp-approvals.json')
 }
 
+function memoryPath() {
+  return path.join(configDir(), 'MEMORY.md')
+}
+
 function readJson(file) {
   if (!fs.existsSync(file)) return null
   try {
@@ -34,13 +38,52 @@ function readJson(file) {
   }
 }
 
+
+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.
+- 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 ensureMemoryRules() {
+  const target = memoryPath()
+  let content = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
+  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()
+  }
+  const before = content
+  if (content) content += '\n\n'
+  content += MEMORY_BLOCK + '\n'
+  if (content === before) return false
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.writeFileSync(target, content, 'utf8')
+  return true
+}
+
 function isInstalled() {
   const config = readJson(configPath())
   const entry = config && config.mcpServers && config.mcpServers['mio-intelligence']
   if (!entry) return false
 
   const approvals = readJson(approvalsPath()) || {}
-  return Boolean(approvals[approvalKey('mio-intelligence', entry)])
+  const memory = fs.existsSync(memoryPath()) ? fs.readFileSync(memoryPath(), 'utf8') : ''
+  return Boolean(
+    approvals[approvalKey('mio-intelligence', entry)] &&
+    memory.includes(MEMORY_BEGIN) &&
+    memory.includes(MEMORY_END)
+  )
 }
 
 function approvalKey(name, entry) {
@@ -107,6 +150,7 @@ function install({ node, serverScript, home, workspace, project }) {
   }
 
   writeApproval('mio-intelligence', config.mcpServers['mio-intelligence'])
+  const memoryChanged = ensureMemoryRules()
 
   const backup = `${target}.bak-mio-${Date.now()}`
   if (fs.existsSync(target)) {
@@ -120,9 +164,11 @@ function install({ node, serverScript, home, workspace, project }) {
     changed: true,
     configPath: target,
     approvalsPath: approvalsPath(),
+    memoryPath: memoryPath(),
+    memoryChanged,
     backup,
-    message: 'WorkBuddy Mio MCP installed and approved. WorkBuddy should auto-load it; restart if it was already running.',
+    message: 'WorkBuddy Mio MCP installed, approved, and auto-memory rules injected. WorkBuddy should auto-load it; restart if it was already running.',
   }
 }
 
-module.exports = { configDir, configPath, approvalsPath, approvalKey, isInstalled, install }
+module.exports = { configDir, configPath, approvalsPath, memoryPath, approvalKey, isInstalled, install }

package/package.json

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