@kisev/memomatic 1.0.0-dev.61.gdf462654550b → 1.0.0-dev.63.g16bac7f2191d

package/README.md

@@ -15,8 +15,9 @@ npm install --global @kisev/memomatic
 
 The corpus lives under `$XDG_STATE_HOME/memomatic/` (`MEMORY.md`, `USER.md`,
 daily notes, `DREAMS.md`); rules live in `$XDG_CONFIG_HOME/memomatic/MEMORY_RULES.md`.
-Requires Node.js 22+. Explicitly select `memomatic` in the `@kisev/agentomatic`
-installer and restart OpenCode. For standalone use, run the CLI:
+Requires Node.js 22+. Connect `memomatic mcp-serve` as a local stdio MCP server
+in OpenCode, Kilo, MiMo, or another MCP host and restart that host. No plugin or
+automatic context injection is used. For background processing, run the CLI:
 
 ```bash
 memomatic process    # validate the inbox and index accepted entries (no model)
@@ -49,16 +50,17 @@ Every entry can carry a `source` annotation. Visibility derives from it:
 `team-*`, `gitlab`, and `spec-manage` entries may be quoted in team-facing
 artifacts; every other source (`people-journal`, `stopit`,
 `mattermost-triage`, `task-*`, `docs-*`, `user`) is personal-only. The label
-is exposed in search responses and session bootstrap blocks.
+is exposed in search responses.
 
 ## Surfaces
 
 - `memomatic` CLI: `process`, `dream`, `search`, `status`, `index`.
 - MCP stdio server with `memory_search`, `memory_get`, `memory_write`, and
   `memory_forget` tools.
-- The OpenCode plugin re-exported by `@kisev/agentomatic`; its bootstrap
-  injects curated memory plus project- and trigger-matched recall blocks
-  resolved from the session database (`projects` map in `settings.json`).
+
+The model initiates memory searches through visible MCP tool calls. Dream
+processes OpenCode history separately; connecting another host does not import
+its session history. Agentomatic and memomatic are installed independently.
 
 Nothing is deleted without the explicit directives documented in
 `MEMORY_RULES.md`.

package/README.ru.md

@@ -15,8 +15,9 @@ npm install --global @kisev/memomatic
 
 Корпус живёт в `$XDG_STATE_HOME/memomatic/` (`MEMORY.md`, `USER.md`, ежедневные
 записи, `DREAMS.md`); правила — в `$XDG_CONFIG_HOME/memomatic/MEMORY_RULES.md`.
-Нужен Node.js 22+. Явно выберите `memomatic` в установщике `@kisev/agentomatic`
-и перезапустите OpenCode. Автономное использование доступно через CLI:
+Нужен Node.js 22+. Подключите `memomatic mcp-serve` как локальный MCP-сервер stdio
+в OpenCode, Kilo, MiMo или другом MCP-хосте и перезапустите хост. Плагин и
+автоматическая подстановка контекста не используются. Фоновая обработка доступна через CLI:
 
 ```bash
 memomatic process    # валидация inbox и индексация принятого (без модели)
@@ -49,15 +50,16 @@ memomatic dream      # полный проход: inbox + сессии + кон
 записи `team-*`, `gitlab` и `spec-manage` можно цитировать в командных
 артефактах; остальные источники (`people-journal`, `stopit`,
 `mattermost-triage`, `task-*`, `docs-*`, `user`) — personal-only. Метка
-возвращается в поиске и в bootstrap-блоках сессий.
+возвращается в поиске.
 
 ## Поверхности
 
 - CLI `memomatic`: `process`, `dream`, `search`, `status`, `index`.
 - MCP-сервер stdio с инструментами `memory_search`, `memory_get`,
   `memory_write` и `memory_forget`.
-- Плагин OpenCode, реэкспортируемый пакетом `@kisev/agentomatic`; его
-  bootstrap добавляет к кураторской памяти блоки напоминаний по проекту и
-  trigger-фразам (контекст сессии и маппинг `projects` из `settings.json`).
+
+Модель сама инициирует поиск памяти через видимые MCP-вызовы. Dream отдельно
+обрабатывает историю OpenCode; подключение другого хоста не импортирует его
+сессии. Agentomatic и memomatic устанавливаются независимо.
 
 Без явных директив, описанных в `MEMORY_RULES.md`, ничего не удаляется.

package/dist/executor.js

@@ -23,16 +23,26 @@ export class OpenCodeExecutor {
         this.options = options;
     }
     async complete(request) {
-        const args = ["run", "--agent", "build"];
+        const args = ["run", "--agent", "build", "--format", "json"];
         if (this.options.model)
             args.push("--model", this.options.model);
         if (this.options.variant)
             args.push("--variant", this.options.variant);
-        args.push("--message", `[memomatic-internal] ${request.system}\n\n${request.prompt}`);
+        args.push("--", `[memomatic-internal] ${request.system}\n\n${request.prompt}`);
         for (let attempt = 0; attempt < 2; attempt += 1) {
             const output = await this.spawnOnce(args);
             try {
-                const parsed = extractJson(output);
+                const texts = [];
+                for (const line of output.split("\n")) {
+                    if (!line.trim())
+                        continue;
+                    const event = JSON.parse(line);
+                    if (event.type === "error")
+                        throw new Error("opencode returned an error event");
+                    if (event.type === "text" && typeof event.part?.text === "string")
+                        texts.push(event.part.text);
+                }
+                const parsed = extractJson(texts.join("\n"));
                 return JSON.stringify(parsed);
             }
             catch {

package/dist/index.d.ts

@@ -4,5 +4,4 @@ export { visibilityForSource } from "./visibility.js";
 export { dropToInbox, processInbox, withRunLock } from "./inbox.js";
 export { forgetEntry, getEntry, openMemomatic, searchMemory, searchMemoryResults, writeEntry, } from "./service.js";
 export type { MemomaticContext } from "./service.js";
-export { bootstrapContext, resolveProject } from "./bootstrap.js";
-export { opencodeDatabasePath, sessionFacts } from "./ingest.js";
+export { opencodeDatabasePath } from "./ingest.js";

package/dist/index.js

@@ -3,5 +3,4 @@ export { entryLine, parseEntryLine } from "./entries.js";
 export { visibilityForSource } from "./visibility.js";
 export { dropToInbox, processInbox, withRunLock } from "./inbox.js";
 export { forgetEntry, getEntry, openMemomatic, searchMemory, searchMemoryResults, writeEntry, } from "./service.js";
-export { bootstrapContext, resolveProject } from "./bootstrap.js";
-export { opencodeDatabasePath, sessionFacts } from "./ingest.js";
+export { opencodeDatabasePath } from "./ingest.js";

package/dist/ingest.d.ts

@@ -9,17 +9,6 @@ export type IngestSession = {
     }>;
 };
 export declare function opencodeDatabasePath(): string;
-export type SessionFacts = {
-    directory: string | null;
-    title: string | null;
-    firstMessage: string | null;
-};
-/**
- * Resolve session context for the bootstrap block: working directory, title,
- * and the first user message, read-only from the OpenCode database. Returns
- * nulls when the session or database is unavailable.
- */
-export declare function sessionFacts(databaseFile: string, sessionId: string): SessionFacts;
 export declare function loadRecentSessions(databaseFile: string, afterTimeCreated: number, options?: {
     maxSessions: number;
     maxCharsPerSession: number;

package/dist/ingest.js

@@ -9,60 +9,33 @@ export function opencodeDatabasePath() {
         throw new Error("XDG_DATA_HOME must be an absolute path");
     return join(base, "opencode", "opencode.db");
 }
-/**
- * Resolve session context for the bootstrap block: working directory, title,
- * and the first user message, read-only from the OpenCode database. Returns
- * nulls when the session or database is unavailable.
- */
-export function sessionFacts(databaseFile, sessionId) {
-    let db;
-    try {
-        db = new DatabaseSync(databaseFile, { readOnly: true });
-    }
-    catch {
-        return { directory: null, title: null, firstMessage: null };
-    }
-    try {
-        const session = db
-            .prepare("SELECT directory, title FROM session WHERE id = ?;")
-            .get(sessionId);
-        let firstMessage = null;
-        const rows = db
-            .prepare(`SELECT data FROM message WHERE session_id = ? ORDER BY time_created ASC LIMIT 20;`)
-            .all(sessionId);
-        for (const row of rows) {
-            try {
-                const parsed = JSON.parse(row.data);
-                if (parsed.role !== "user")
-                    continue;
-                const texts = [];
-                for (const part of parsed.parts ?? []) {
-                    const value = part;
-                    if (value.type === "text" && typeof value.text === "string")
-                        texts.push(value.text);
+function readMessages(db, sessionId) {
+    const hasParts = db
+        .prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'part'")
+        .get();
+    const rows = db
+        .prepare(`SELECT ${hasParts ? "id, " : ""}data FROM message WHERE session_id = ? ORDER BY time_created ASC;`)
+        .all(sessionId);
+    if (!hasParts)
+        return rows;
+    const parts = db.prepare("SELECT data FROM part WHERE message_id = ? ORDER BY time_created ASC, id ASC");
+    return rows.map((row) => {
+        try {
+            const message = JSON.parse(row.data);
+            message.parts = parts.all(row.id).flatMap((part) => {
+                try {
+                    return [JSON.parse(part.data)];
                 }
-                const text = texts.join("\n").trim();
-                if (text) {
-                    firstMessage = text;
-                    break;
+                catch {
+                    return [];
                 }
-            }
-            catch {
-                continue;
-            }
+            });
+            return { data: JSON.stringify(message) };
         }
-        return {
-            directory: session?.directory ?? null,
-            title: session?.title ?? null,
-            firstMessage,
-        };
-    }
-    catch {
-        return { directory: null, title: null, firstMessage: null };
-    }
-    finally {
-        db.close();
-    }
+        catch {
+            return row;
+        }
+    });
 }
 export function loadRecentSessions(databaseFile, afterTimeCreated, options = {
     maxSessions: 20,
@@ -86,9 +59,7 @@ export function loadRecentSessions(databaseFile, afterTimeCreated, options = {
             const messages = [];
             let budget = options.maxCharsPerSession;
             let internal = false;
-            const rows = db
-                .prepare(`SELECT data FROM message WHERE session_id = ? ORDER BY time_created ASC;`)
-                .all(session.id);
+            const rows = readMessages(db, session.id);
             for (const row of rows) {
                 if (budget <= 0)
                     break;

package/dist/service.js

@@ -3,7 +3,7 @@ import { readTextIfExists, replaceEntryLine, writeCorpusFile } from "./corpus.js
 import { assertSafePath } from "@kisev/safe-fs";
 import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { rm } from "node:fs/promises";
-import { dropToInbox } from "./inbox.js";
+import { dropToInbox, withRunLock } from "./inbox.js";
 import { isForbidden, loadRules } from "./rules.js";
 import { memomaticPaths } from "./paths.js";
 import { loadSettings } from "./settings.js";
@@ -79,15 +79,23 @@ export async function getEntry(context, file, line) {
     return { file: target, line, content: lines[line - 1] };
 }
 export async function forgetEntry(context, target) {
-    const file = await memoryPath(context, target.file);
-    const content = await readTextIfExists(file);
-    if (content === undefined)
-        throw new Error(`memory file not found: ${target.file}`);
-    const lines = content.split("\n");
-    if (!Number.isSafeInteger(target.line) || target.line < 1 || target.line > lines.length)
-        throw new Error("line is out of range");
-    await replaceEntryLine(context.paths, file, target.line, null);
-    return file;
+    return withRunLock(context.paths, async () => {
+        const file = await memoryPath(context, target.file);
+        const content = await readTextIfExists(file);
+        if (content === undefined)
+            throw new Error(`memory file not found: ${target.file}`);
+        const lines = content.split("\n");
+        if (!Number.isSafeInteger(target.line) || target.line < 1 || target.line > lines.length)
+            throw new Error("line is out of range");
+        await replaceEntryLine(context.paths, file, target.line, null);
+        context.store.replaceEntries(context.store
+            .allEntries()
+            .filter((entry) => entry.file !== file || entry.line !== target.line)
+            .map((entry) => entry.file === file && entry.line > target.line
+            ? { ...entry, line: entry.line - 1 }
+            : entry));
+        return file;
+    });
 }
 export async function archiveOldEpisodic(context) {
     const archived = [];

package/dist/settings.d.ts

@@ -3,7 +3,6 @@ export type MemomaticSettings = {
         url: string;
         model: string;
     } | null;
-    projects: Record<string, string>;
     dream: {
         model: string | null;
         variant: string | null;

package/dist/settings.js

@@ -1,7 +1,6 @@
 import { readFile } from "node:fs/promises";
 export const defaultSettings = () => ({
     embedding: null,
-    projects: {},
     dream: {
         model: null,
         variant: null,
@@ -29,19 +28,10 @@ export function normalizeSettings(raw) {
     const defaults = defaultSettings();
     const source = (raw ?? {});
     const embedding = source.embedding;
-    const rawProjects = source.projects;
-    const projects = {};
-    if (rawProjects && typeof rawProjects === "object") {
-        for (const [prefix, name] of Object.entries(rawProjects)) {
-            if (typeof name === "string" && name.trim() && prefix.trim())
-                projects[prefix] = name.trim();
-        }
-    }
     return {
         embedding: embedding && typeof embedding.url === "string" && typeof embedding.model === "string"
             ? { url: embedding.url, model: embedding.model }
             : null,
-        projects,
         dream: mergeSection(defaults.dream, source.dream),
         search: mergeSection(defaults.search, source.search),
         archive: mergeSection(defaults.archive, source.archive),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kisev/memomatic",
-  "version": "1.0.0-dev.61.gdf462654550b",
+  "version": "1.0.0-dev.63.g16bac7f2191d",
   "description": "Personal learning memory for agents: tiered Markdown corpus, rebuildable index, dream sweep.",
   "homepage": "https://github.com/kisev/skills#readme",
   "bugs": {
@@ -34,7 +34,7 @@
     "pack:check": "node test/pack-allowlist.mjs"
   },
   "dependencies": {
-    "@kisev/safe-fs": "1.0.0-dev.61.gdf462654550b"
+    "@kisev/safe-fs": "1.0.0-dev.63.g16bac7f2191d"
   },
   "devDependencies": {
     "@types/node": "22.15.30",

package/dist/bootstrap.d.ts

@@ -1,19 +0,0 @@
-import type { MemomaticContext } from "./service.js";
-export type SessionFacts = {
-    directory: string | null;
-    title: string | null;
-    firstMessage: string | null;
-};
-export type BootstrapOptions = {
-    curatedBudgetChars?: number;
-    episodicBudgetChars?: number;
-};
-/** Longest-prefix match of a working directory against the projects map. */
-export declare function resolveProject(directory: string | null, projects: Record<string, string>): string | null;
-/**
- * Build the session bootstrap context: curated MEMORY.md and USER.md heads,
- * plus episodic entries matched by project annotation and trigger phrases.
- * Every episodic line carries its source visibility so team-facing artifacts
- * never quote personal-only memory.
- */
-export declare function bootstrapContext(context: MemomaticContext, facts: SessionFacts, options?: BootstrapOptions): Promise<string | null>;

package/dist/bootstrap.js

@@ -1,84 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { visibilityForSource } from "./visibility.js";
-const DEFAULT_CURATED_BUDGET = 4_000;
-const DEFAULT_EPISODIC_BUDGET = 1_500;
-const MAX_BLOCK_ENTRIES = 8;
-/** Longest-prefix match of a working directory against the projects map. */
-export function resolveProject(directory, projects) {
-    if (!directory)
-        return null;
-    let best = null;
-    for (const [prefix, name] of Object.entries(projects)) {
-        if (directory === prefix || directory.startsWith(prefix.endsWith("/") ? prefix : `${prefix}/`))
-            if (!best || prefix.length > best.prefix.length)
-                best = { prefix, name };
-    }
-    return best?.name ?? null;
-}
-function renderEntry(entry) {
-    const visibility = visibilityForSource(entry.source);
-    const label = entry.source ? `source: ${entry.source}, ${visibility}-only` : `${visibility}-only`;
-    const text = entry.text.startsWith("- ") ? entry.text.slice(2) : entry.text;
-    return `- ${text} (${label})`;
-}
-function rankEntries(entries) {
-    return [...entries].sort((left, right) => {
-        if (right.importance !== left.importance)
-            return right.importance - left.importance;
-        return (right.observedAt ?? 0) - (left.observedAt ?? 0);
-    });
-}
-function fitsBudget(lines, budget) {
-    const result = [];
-    let used = 0;
-    for (const line of lines) {
-        if (result.length >= MAX_BLOCK_ENTRIES)
-            break;
-        if (used + line.length > budget)
-            break;
-        result.push(line);
-        used += line.length + 1;
-    }
-    return result;
-}
-/**
- * Build the session bootstrap context: curated MEMORY.md and USER.md heads,
- * plus episodic entries matched by project annotation and trigger phrases.
- * Every episodic line carries its source visibility so team-facing artifacts
- * never quote personal-only memory.
- */
-export async function bootstrapContext(context, facts, options = {}) {
-    const curatedBudget = options.curatedBudgetChars ?? DEFAULT_CURATED_BUDGET;
-    const episodicBudget = options.episodicBudgetChars ?? DEFAULT_EPISODIC_BUDGET;
-    const blocks = [];
-    for (const file of [context.paths.memoryFile, context.paths.userFile]) {
-        const content = await readFile(file, "utf8").catch(() => undefined);
-        if (content === undefined || !content.trim())
-            continue;
-        const name = file.slice(file.lastIndexOf("/") + 1);
-        blocks.push(`# Memomatic ${name}\n\n${content.trim().slice(0, curatedBudget)}`);
-    }
-    const entries = context.store.allEntries().filter((entry) => entry.status === null);
-    const project = resolveProject(facts.directory, context.settings.projects);
-    const usedTexts = new Set();
-    if (project) {
-        const lines = rankEntries(entries.filter((entry) => entry.kind === "episodic" && entry.project === project)).map((entry) => {
-            usedTexts.add(entry.text);
-            return renderEntry(entry);
-        });
-        const fitted = fitsBudget(lines, episodicBudget);
-        if (fitted.length)
-            blocks.push(`# Memomatic project recall (${project})\n\n${fitted.join("\n")}\n\nEntries marked personal-only must never be quoted in team-facing artifacts.`);
-    }
-    const haystack = [facts.title ?? "", facts.firstMessage ?? ""].join("\n").toLowerCase();
-    if (haystack.trim()) {
-        const triggered = rankEntries(entries.filter((entry) => !usedTexts.has(entry.text) &&
-            entry.trigger.some((phrase) => phrase.trim() && haystack.includes(phrase.toLowerCase())))).map((entry) => renderEntry(entry));
-        const fitted = fitsBudget(triggered, episodicBudget);
-        if (fitted.length)
-            blocks.push(`# Memomatic triggered recall\n\n${fitted.join("\n")}\n\nEntries marked personal-only must never be quoted in team-facing artifacts.`);
-    }
-    if (!blocks.length)
-        return null;
-    return `${blocks.join("\n\n")}\n\nUse memory_search for details and memory_write to queue durable outcomes. Never re-save content that is already present in this memory.`;
-}