mio-agent-runtime 0.2.4 → 0.2.6

package/README.md

@@ -31,9 +31,11 @@ mio --json agents           Machine-readable agents
   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/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.
+  writes both files and injects Mio usage rules into
+  `~/.workbuddy/WORKBUDDY.md` (user-level memory rules, auto-loaded by
+  WorkBuddy into every session) plus `<workspace>/AGENTS.md` (project-level).
+  If WorkBuddy is already running, restart it once so it reloads the approval
+  and memory rule files.
 
 ## MIO_HOME
 
@@ -51,4 +53,4 @@ packages/mio-cli
 ├── server/
 │   └── mio-intelligence-mcp/index.js
 └── package.json
-```
+```

package/adapters/opencode.js

@@ -15,6 +15,8 @@ Mio MCP tools are available. Treat these as mandatory runtime rules for every wo
 - 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.
 ${INSTRUCTIONS_END}`

package/adapters/workbuddy.js

@@ -25,8 +25,17 @@ function approvalsPath() {
   return path.join(configDir(), 'mcp-approvals.json')
 }
 
-function memoryPath() {
-  return path.join(configDir(), 'MEMORY.md')
+// User-level memory rules file. WorkBuddy's codebuddy CLI auto-loads
+// WORKBUDDY.md (or WORKBUDDY.mdc) from the config dir into every session
+// (MemoryLoader user scope -> system-reminder-md / prompt context).
+function memoryRulesPath() {
+  return path.join(configDir(), 'WORKBUDDY.md')
+}
+
+// Project-level memory rules. WorkBuddy walks up from the workspace dir and
+// auto-loads WORKBUDDY.md / AGENTS.md (project scope) into every session.
+function projectInstructionsPath(workspace) {
+  return path.join(workspace || process.cwd(), 'AGENTS.md')
 }
 
 function readJson(file) {
@@ -49,12 +58,13 @@ Mio MCP tools are available. Treat these as mandatory runtime rules for every wo
 - 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 ensureMemoryRules() {
-  const target = memoryPath()
+function ensureBlock(target) {
   let content = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : ''
   const original = content
   const start = content.indexOf(MEMORY_BEGIN)
@@ -65,10 +75,12 @@ function ensureMemoryRules() {
   }
   if (content) content += '\n\n'
   content += MEMORY_BLOCK + '\n'
-  if (content === original) return false
+  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 true
+  return { changed: true, target, backup }
 }
 
 function isInstalled() {
@@ -77,7 +89,7 @@ function isInstalled() {
   if (!entry) return false
 
   const approvals = readJson(approvalsPath()) || {}
-  const memory = fs.existsSync(memoryPath()) ? fs.readFileSync(memoryPath(), 'utf8') : ''
+  const memory = fs.existsSync(memoryRulesPath()) ? fs.readFileSync(memoryRulesPath(), 'utf8') : ''
   return Boolean(
     approvals[approvalKey('mio-intelligence', entry)] &&
     memory.includes(MEMORY_BEGIN) &&
@@ -149,7 +161,6 @@ 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)) {
@@ -159,15 +170,26 @@ function install({ node, serverScript, home, workspace, project }) {
   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: true,
+    changed,
     configPath: target,
     approvalsPath: approvalsPath(),
-    memoryPath: memoryPath(),
-    memoryChanged,
+    memoryRulesPath: userRules.target,
+    projectInstructionsPath: projectRules ? projectRules.target : null,
+    userRulesChanged: userRules.changed,
+    projectRulesChanged: projectRules ? projectRules.changed : false,
     backup,
-    message: 'WorkBuddy Mio MCP installed, approved, and auto-memory rules injected. WorkBuddy should auto-load it; restart if it was already running.',
+    message: 'WorkBuddy Mio MCP installed, approved, and Mio rules injected into WORKBUDDY.md (auto-loaded user memory) and the workspace AGENTS.md. Restart WorkBuddy to load them.',
   }
 }
 
-module.exports = { configDir, configPath, approvalsPath, memoryPath, approvalKey, isInstalled, install }
+module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install }

package/package.json

@@ -1,23 +1,23 @@
-{
-  "name": "mio-agent-runtime",
-  "version": "0.2.4",
-  "description": "Mio Agent Runtime installer and MCP intelligence layer",
-  "license": "MIT",
-  "type": "commonjs",
-  "bin": {
-    "mio": "bin/mio.js"
-  },
-  "files": [
-    "bin/",
-    "server/",
-    "adapters/",
-    "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",
-    "prepack": "npm run check"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "mio-agent-runtime",
+  "version": "0.2.6",
+  "description": "Mio Agent Runtime installer and MCP intelligence layer",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "mio": "bin/mio.js"
+  },
+  "files": [
+    "bin/",
+    "server/",
+    "adapters/",
+    "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",
+    "prepack": "npm run check"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}