@aionis/mcp 0.1.6 → 0.1.8

package/README.md

@@ -5,12 +5,23 @@ MCP stdio bridge for Aionis execution memory.
 Docs: [https://docs.aionis.work/integrations/mcp](https://docs.aionis.work/integrations/mcp)
 
 Use this package when you want Claude Code, Cursor, or another MCP client to
-try Aionis without rewriting the host Agent loop first.
+try Aionis without rewriting the host Agent loop first. MCP is the fastest
+public trial path for Aionis Execution Memory: connect the bridge, call
+`aionis_context`, and let the Agent continue from governed state instead of raw
+chat history.
 
 ```bash
 npx @aionis/mcp@latest --base-url http://127.0.0.1:3001 --scope my-project
 ```
 
+Start a local Runtime first:
+
+```bash
+npx @aionis/create@latest
+cd Aionis
+npm run -s lite:start
+```
+
 Environment form:
 
 ```bash
@@ -27,7 +38,7 @@ The server exposes stable product tools, not internal Runtime packets:
 | Tool | Purpose |
 |---|---|
 | `aionis_context` | Compile governed Agent context for the current run. Optionally records a lightweight observation first. |
-| `aionis_record_step` | Record a planner/worker/verifier/reviewer step. Feedback attribution is optional. |
+| `aionis_record_step` | Record a planner/worker/verifier/reviewer step, including planner plan assets and rejected branch evidence. Feedback attribution is optional. |
 | `aionis_handoff` | Record branch-aware multi-agent handoff state. |
 | `aionis_remember` | Store ordinary project memory through the governed observe path. |
 | `aionis_govern_memory` | Route external Mem0/Zep/vector/markdown candidates through Aionis Memory Firewall before prompt use. |
@@ -48,6 +59,26 @@ Runtime guide, and `budget_profile`, `max_prompt_chars`, `repo_state`, and
 For example, pass `repo_state.missing_files` so Aionis can tell the Agent that a
 missing active target is pending work rather than stale memory.
 
+For Claude Code or Cursor demos, the recommended first loop is:
+
+```text
+aionis_context -> Agent action -> aionis_record_step -> aionis_flight_recorder
+```
+
+Use this flow:
+
+1. Use `aionis_record_step` as a planner to record the accepted plan,
+   active targets, acceptance checks, and execution boundary.
+2. Use `aionis_record_step` again for any rejected branch as `outcome:
+   "failed"` with the rejected target files.
+3. Ask `aionis_context` for the worker/reviewer context before implementation.
+4. Use `aionis_flight_recorder` after the run to replay which plan memories and
+   failed branches were visible at decision time.
+
+This is the MCP shape of Aionis Plan as Memory Asset: the MCP client can use a
+strong planner once, then let later workers continue from adjudicated execution
+memory instead of raw chat history.
+
 The tool returns these structured fields in `structuredContent`:
 
 | Field | Meaning |
@@ -63,8 +94,10 @@ The tool returns these structured fields in `structuredContent`:
 | `inspect_first_memory_ids` | Candidate or contested memories that require inspection before action. |
 | `rehydrate_first_memory_ids` | Compact pointers that need raw payload recovery before exact use. |
 
-Use `aionis_govern_memory` when an MCP client already has memories from another
-backend and needs Aionis to decide which ones may direct the Agent:
+Use `aionis_govern_memory` when an MCP client already has memories from Mem0,
+Zep, Supermemory, Pinecone, pgvector, Chroma, Weaviate, LangGraph Store,
+markdown, logs, or another backend and needs Aionis to decide which ones may
+direct the Agent:
 
 ```json
 {

package/dist/server.js

@@ -55,7 +55,7 @@ function register(server, client, name, config) {
 export function createAionisMcpServer(client) {
     const server = new McpServer({
         name: "aionis-mcp",
-        version: "0.1.6",
+        version: "0.1.8",
     });
     register(server, client, "aionis_context", {
         title: "Get Aionis Agent Context",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aionis/mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "MCP stdio bridge for Aionis execution memory.",
   "license": "Apache-2.0",
   "homepage": "https://docs.aionis.work/integrations/mcp",
@@ -26,7 +26,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@aionis/sdk": "^0.1.9",
+    "@aionis/sdk": "^0.1.10",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76"
   },