@mono-agent/agent-app 0.2.1 → 0.3.0

package/skills/mono-agent-composer/references/config-blueprint.md

@@ -32,7 +32,7 @@ my-agent/
     "effort": "medium",                    // none|low|medium|high|xhigh|max
     "permissionMode": "default",           // default|plan|acceptEdits|bypassPermissions (CLI backends)
     "reasoningSummary": "auto",            // auto|concise|detailed|off|on
-    "maxTurns": 8,                         // 1-100
+    "maxTurns": 0,                         // 0 or omitted means unlimited; 1-100 caps turns
     "workspace": ".",
     "session": { "mode": "continuous", "idleTimeoutMs": 1800000 } // or "per-message"
   },
@@ -63,20 +63,32 @@ my-agent/
   },
 
   // Memory strategy. Omit the section for no memory.
+  // Three tiers over one substrate (memory-store + memory-bujo):
+  //   lite    — FTS keyword recall + rapid-log; no external deps.
+  //   journal — + hybrid recall (BM25+vector) + decay; needs Ollama embeddings.
+  //   bujo    — + LLM capture/reconcile + entity graph + auto-scheduled
+  //             reflection/migration; needs Ollama embeddings + chat model.
   "memory": {
-    "mode": "journal",                     // markdown | journal
-    "path": "./.mono-agent/memory",        // file for markdown, root dir for journal
+    "mode": "bujo",                        // lite | journal | bujo
+    "path": "./.mono-agent/memory",        // root directory for all tiers
     "writeMode": "append-host-summary",    // disabled | append-host-summary
-    "scope": "single-file",                // markdown only: single-file | per-conversation
     "maxBytes": 64000,
-    "tools": { "enabled": true, "allowJournalAppend": true }, // journal only: MCP recall tools
-    "graphPath": "./.mono-agent/memory/graph.jsonl",          // journal only; this is the default
-    "embeddings": {                        // optional: semantic memory_search
+    "embeddings": {                        // required for journal and bujo
       "provider": "ollama",                // ollama | openai
-      "model": "nomic-embed-text",         // default per provider
+      "model": "nomic-embed-text:v1.5",   // use exact :v1.5 tag (pull first with ollama pull)
       "endpoint": "http://localhost:11434",
-      "apiKeyEnv": "OPENAI_API_KEY"        // or inline "apiKey"; required for openai
-    }
+      "apiKeyEnv": "OPENAI_API_KEY",       // or inline "apiKey"; required for openai
+      "dim": 768                           // nomic-embed-text:v1.5 output dimension
+    },
+    "llm": {                               // required for bujo; omit for lite/journal
+      "provider": "ollama",
+      "model": "qwen3.6:latest",           // any local Ollama chat model; also set MONO_AGENT_MEMORY_LLM_MODEL for CLI
+      "endpoint": "http://localhost:11434" // optional; defaults to http://localhost:11434
+    },
+    // Bujo auto-scheduler — override defaults or disable per-ritual.
+    // Rituals run in-app; no external cron or launchd needed.
+    "reflection": { "enabled": true, "cron": "0 3 * * *" },  // default: nightly 03:00
+    "migration":  { "enabled": true, "cron": "0 4 1 * *" }   // default: 1st of month 04:00
   },
 
   // Fail-closed tool policy + MCP servers. Deny wins; overlap is rejected.
@@ -138,12 +150,14 @@ my-agent/
   },
 
   "telegram": {
+    "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "botToken": "...",
     "allowedChatIds": ["123456789"],       // or "allowAllChats": true
     "allowAllChats": false
   },
 
   "slack": {
+    "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "botToken": "xoxb-...",                // Socket Mode app
     "appToken": "xapp-...",
     "allowedChannelIds": ["C0123"],        // or "allowAllChannels": true
@@ -154,6 +168,7 @@ my-agent/
   },
 
   "whatsapp": {
+    "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "allowedChatJids": ["123@s.whatsapp.net"], // or "allowAllChats": true
     "allowAllChats": false,
     "groupMode": "mention",                // mention | any (group trigger rule)
@@ -187,6 +202,7 @@ my-agent/
   },
 
   "cron": {
+    "dir": "cron",                         // optional: folder of *.md jobs (frontmatter + prompt body), default "cron"
     "jobs": [
       {
         "id": "daily",
@@ -197,6 +213,7 @@ my-agent/
         "conversationId": "cron-daily"     // optional: share memory/history across ticks
       }
     ]
+    // Jobs here merge with cron/*.md files (duplicate ids error).
     // Overlapping ticks of the same job are skipped, never queued.
   }
 }
@@ -205,7 +222,7 @@ my-agent/
 ## Lifecycle
 
 ```bash
-mono-agent init --model claude:claude-sonnet-4-6 --fallback-models pi:ollama:gemma4:31b [--memory markdown|journal]
+mono-agent init --model claude:claude-sonnet-4-6 --fallback-models pi:ollama:gemma4:31b [--memory lite|journal|bujo]
 mono-agent validate     # per-section report incl. sandbox, console, every channel; exit 0 means ready
 mono-agent start        # console + traceability + every configured channel
 mono-agent start --no-console   # headless (or "console": { "enabled": false })

package/skills/mono-agent-composer/references/discovery-questions.md

@@ -84,12 +84,108 @@ Question:
 Should the agent remember anything between conversations?
 
 1. No durable memory yet (recommended for first integration)
-2. Markdown memory file (read into context; optional host summaries appended)
-3. Journal memory (daily notes + entity graph, optional MCP recall tools)
-4. Journal memory with semantic search (adds an embedding index for memory_search)
+2. Lite memory — FTS keyword recall + rapid-log capture; zero external deps
+3. Journal memory — hybrid recall (BM25+vector) + salience decay; requires local Ollama embeddings
+4. BuJo memory — full tier: journal + LLM capture/reconcile + entity graph + auto-scheduled
+   reflection/migration; requires Ollama embeddings AND a local chat model
 ```
 
-Fills: the `memory` section — `mode` (`markdown`/`journal`), `path`, `writeMode` (`disabled`/`append-host-summary`), `scope`, and for journal mode `tools.enabled` / `tools.allowJournalAppend` to give the runtime memory recall/append tools over MCP. The entity graph defaults to `<path>/graph.jsonl` (`memory.graphPath` to relocate). For semantic search fill `memory.embeddings`: `provider` (`ollama` with local `nomic-embed-text` — pull it first with `ollama pull nomic-embed-text` — or `openai` which requires `apiKey`/`apiKeyEnv`), optional `model`/`endpoint`. Without embeddings, `memory_search` falls back to keyword search.
+All tiers share the same `@mono-agent/memory-bujo` substrate. Fills: `memory.mode`
+(`lite`/`journal`/`bujo`), `memory.path`, `memory.writeMode`
+(`disabled`/`append-host-summary`), and tier-specific blocks below.
+
+**Tier 2 — lite (no external deps):**
+
+Write:
+
+```jsonc
+"memory": {
+  "mode": "lite",
+  "path": "./.mono-agent/memory",
+  "writeMode": "append-host-summary"
+}
+```
+
+No prerequisites. No Ollama. SQLite is bundled.
+
+**Tier 3 — journal (embeddings required):**
+
+- Ask: which local Ollama embeddings model? (default `nomic-embed-text:v1.5` — use the
+  exact `:v1.5` tag; pull first with `ollama pull nomic-embed-text:v1.5`).
+- Default `memory.embeddings.dim` to `768` for `nomic-embed-text:v1.5`.
+
+Write:
+
+```jsonc
+"memory": {
+  "mode": "journal",
+  "path": "./.mono-agent/memory",
+  "writeMode": "append-host-summary",
+  "embeddings": {
+    "provider": "ollama",
+    "model": "nomic-embed-text:v1.5",
+    "dim": 768
+  }
+}
+```
+
+After writing, remind the user to run `mono-agent validate` (checks Ollama reachability
+and that the model is pulled — warns loudly on any failure, never silently falls back).
+
+**Tier 4 — bujo (embeddings + chat model + auto-rituals):**
+
+Proactively explain what bujo does: capture → reconcile (ADD/UPDATE/SUPERSEDE/NOOP),
+hybrid BM25+vector recall, entity graph, reflection (decay + insight synthesis), monthly
+migration (promote/reschedule/cluster/forget), living `index.md` + `future-log.md`.
+The reflection and migration rituals are **auto-scheduled in-app** — no external cron or
+launchd setup needed.
+
+- Ask: which local Ollama embeddings model? (default `nomic-embed-text:v1.5` — exact
+  `:v1.5` tag; `ollama pull nomic-embed-text:v1.5`).
+- Ask: which local chat model for LLM pipelines? (e.g. `qwen3.6:latest`;
+  `ollama pull qwen3.6:latest`). A chat model is required — without it the `bujo` tier
+  cannot run capture/reflect/migrate.
+- Ask: should we keep the default reflection/migration schedule (nightly `0 3 * * *` /
+  monthly `0 4 1 * *`), or customise the cron expressions?
+
+Write (embeddings + chat model):
+
+```jsonc
+"memory": {
+  "mode": "bujo",
+  "path": "./.mono-agent/memory",
+  "writeMode": "append-host-summary",
+  "embeddings": {
+    "provider": "ollama",
+    "model": "nomic-embed-text:v1.5",
+    "dim": 768
+  },
+  "llm": {
+    "provider": "ollama",
+    "model": "qwen3.6:latest"
+  }
+}
+```
+
+If the user customises the ritual schedule, add the `reflection`/`migration` blocks:
+
+```jsonc
+"reflection": { "enabled": true, "cron": "0 3 * * *" },
+"migration":  { "enabled": true, "cron": "0 4 1 * *" }
+```
+
+After writing, append a prerequisite note:
+
+```
+Before running mono-agent validate, pull the required models:
+  ollama pull nomic-embed-text:v1.5
+  ollama pull qwen3.6:latest          # (or whichever chat model you chose)
+```
+
+Then run `mono-agent validate` — the Memory section confirms Ollama reachability, both
+models are present, the root is writable, and the ritual cadence (with next-run times).
+See `docs/memory.md` for the full tier table, config shapes, and CLI subcommands
+(`memory-bujo rebuild|recall|index|reflect|migrate`).
 
 ## 7. Sandbox
 

package/skills/mono-agent-composer/references/feature-coverage.md

@@ -26,15 +26,15 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | Identity + optional soul documents | config | `context.identityPath`, `context.soulPath` |
 | Selected skills from a skills root | config | `context.skillsRoot`, `context.selectedSkills` |
 | Per-skill byte cap | config | `context.skillMaxBytes` |
-| Conversation history (in-memory, capped) | auto | sized from `runtime.maxTurns`; custom store via code |
-| Markdown memory (single-file / per-conversation, capped) | config | `memory.mode: "markdown"`, `path`, `maxBytes`, `scope` |
-| Journal memory (daily notes always in context) | config | `memory.mode: "journal"`, `path` |
+| Conversation history (in-memory; unlimited unless turns are capped) | auto | sized from `runtime.maxTurns`; custom store via code |
+| Lite memory (FTS keyword recall + rapid-log capture; no external deps) | config | `memory.mode: "lite"`, `path`, `maxBytes`, `writeMode` |
+| Journal memory (hybrid recall BM25+vector + salience decay; needs Ollama embeddings) | config | `memory.mode: "journal"`, `path`, `memory.embeddings.{provider,model,dim}` |
+| BuJo memory (journal + LLM capture/reconcile ADD/UPDATE/SUPERSEDE/NOOP + entity graph + auto-scheduled reflection/migration; needs Ollama embeddings + chat model) | config | `memory.mode: "bujo"`, `path`, `memory.embeddings.{provider,model,dim}`, `memory.llm.{provider,model,endpoint}` — see `docs/memory.md` |
+| BuJo reflection auto-scheduler (nightly decay + insight synthesis; in-app, no external cron needed) | config | `memory.reflection.{enabled,cron}` (default `0 3 * * *`); env `MONO_AGENT_MEMORY_REFLECTION_CRON`, `MONO_AGENT_MEMORY_REFLECTION_ENABLED` |
+| BuJo migration auto-scheduler (monthly promote/reschedule/cluster/forget; in-app) | config | `memory.migration.{enabled,cron}` (default `0 4 1 * *`); env `MONO_AGENT_MEMORY_MIGRATION_CRON`, `MONO_AGENT_MEMORY_MIGRATION_ENABLED` |
+| Memory out-of-band maintenance CLI (rebuild/recall/index/reflect/migrate) | cli | `memory-bujo <subcommand> <root>`; opt-in `MONO_AGENT_MEMORY_EMBEDDINGS_PROVIDER`/`_MODEL`/`_DIM` for semantic recall; `MONO_AGENT_MEMORY_LLM_MODEL`, `MONO_AGENT_MEMORY_LLM_ENDPOINT` required for reflect/migrate |
+| Memory liveness check (root writable; Ollama + models for journal/bujo; ritual cadence for bujo — loud warn, no silent fallback) | cli | `mono-agent validate` |
 | Host summaries appended after runs | config | `memory.writeMode: "append-host-summary"` |
-| Entity graph + salience digest in context (journal) | config | automatic; path override `memory.graphPath` |
-| MCP recall tools (`memory_read_day`, `memory_list_days`, `memory_grep`, `memory_search`, `entity_get`) | config | `memory.tools.enabled` |
-| Model-initiated notes (`journal_append`) | config | `memory.tools.allowJournalAppend` |
-| Semantic `memory_search` (Ollama nomic-embed-text or OpenAI embeddings; keyword fallback when unset) | config | `memory.embeddings.{provider,model,endpoint,apiKey,apiKeyEnv}` |
-| Consolidation tools (`entity_upsert`, `memory_reindex`) | code | exposed by `@mono-agent/memory-mcp`, not in the default allowlist |
 
 ## Tools, MCP, sandbox
 

package/skills/mono-agent-composer/references/package-map.md

@@ -48,11 +48,9 @@ Use this path when the agent needs identity, selected skills, history, and optio
 | --- | --- | --- |
 | Prompt assembly | `@mono-agent/context` | Load identity/SOUL/skills/history/memory into deterministic prompt context |
 | Selected skill bodies | `@mono-agent/skills` | Load only configured skills from `<skillsRoot>/<name>/SKILL.md` |
-| Markdown memory | `@mono-agent/memory-md` | Read capped memory blocks and optionally append host summaries |
-| Daily journal memory | `@mono-agent/memory-journal` | Keep a today note in context and persist continuous local journaling |
-| Entity graph memory | `@mono-agent/memory-graph` | Store local JSONL entities, relations, and observations (`memory.graphPath`) |
-| Searchable memory | `@mono-agent/memory-search` | Chunk and semantically search local memory with embeddings (`memory.embeddings`) |
-| Runtime memory tools | `@mono-agent/memory-mcp` | Expose memory tools over MCP when the runtime should query memory itself (`memory.tools`); also ships host-side `entity_upsert`/`memory_reindex` consolidation tools |
+| Memory substrate (schema, migrations, FTS+vector db, RRF) | `@mono-agent/memory-store` | SQLite storage, BM25 FTS, optional vector index, hybrid recall; `MemoryStore`/`MemoryBlock`/`MemoryWriteResult` contract |
+| Memory engine (all tiers: lite/journal/bujo) | `@mono-agent/memory-bujo` | `BujoMemoryStore` — tier-aware: FTS recall (lite), hybrid recall + decay (journal), LLM capture/reconcile + entity graph + reflection/migration + auto-scheduler (bujo) |
+| Embedding providers | `@mono-agent/memory-search` | Ollama/OpenAI embedding providers used by memory-store for vector recall |
 
 Mono-agent selected skills are not auto-selected by description. The host chooses `context.selectedSkills`, and the harness loads those exact bodies.
 
@@ -103,7 +101,7 @@ Communication adapters are edge packages. They accept an `AgentResponder` and ow
 | Webhook | `@mono-agent/webhook-adapter` | `curl` the configured invocation path |
 | Cron | `@mono-agent/cron-adapter` | One scheduled or manually triggered invocation |
 
-Adapters must not import the harness, runtime adapter, memory packages, or other adapters. `@mono-agent/agent-app` composes them from config; custom hosts and demos may compose them directly.
+Adapters must not import the harness, runtime adapter, memory packages (`memory-store`, `memory-bujo`, `memory-search`), or other adapters. `@mono-agent/agent-app` composes them from config; custom hosts and demos may compose them directly.
 
 ## Operator And Observability Join