npm - omnimem - Versions diffs - 0.1.5 → 0.1.7 - Mend

omnimem 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/omnimem/__init__.py +1 -1
package/omnimem/webui.py +301 -1
package/package.json +1 -1
package/templates/project-minimal/.omnimem-session.md +2 -2
package/templates/project-minimal/.omnimem.json +2 -2

package/omnimem/__init__.py CHANGED Viewed

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.1.4"
+__version__ = "0.1.7"

package/omnimem/webui.py CHANGED Viewed

@@ -1,6 +1,7 @@
 from __future__ import annotations
 import json
+import os
 import sqlite3
 import threading
 import time
@@ -74,6 +75,7 @@ HTML_PAGE = """<!doctype html>
       <div class=\"tabs\">
         <button class=\"tab-btn active\" data-tab=\"statusTab\" data-i18n=\"tab_status\">Status & Actions</button>
         <button class=\"tab-btn\" data-tab=\"configTab\" data-i18n=\"tab_config\">Configuration</button>
+        <button class=\"tab-btn\" data-tab=\"projectTab\" data-i18n=\"tab_project\">Project Integration</button>
         <button class=\"tab-btn\" data-tab=\"memoryTab\" data-i18n=\"tab_memory\">Memory</button>
       </div>
     </div>
@@ -121,6 +123,36 @@ HTML_PAGE = """<!doctype html>
       </div>
     </div>
+    <div id=\"projectTab\" class=\"panel\">
+      <div class=\"grid\">
+        <div class=\"card wide\">
+          <h3 data-i18n=\"project_title\">Project Integration</h3>
+          <label><span data-i18n=\"project_path\">Project Path</span><input id=\"projectPath\" placeholder=\"/path/to/your/project\" /></label>
+          <div class=\"row-btn\">
+            <button id=\"btnBrowseProject\" data-i18n=\"btn_browse_project\">Browse Directory</button>
+            <button id=\"btnUseCwd\" data-i18n=\"btn_use_cwd\">Use Server CWD</button>
+          </div>
+          <div id=\"browserPanel\" class=\"card\" style=\"margin-top:10px; display:none;\">
+            <div class=\"small\" data-i18n=\"browser_title\">Directory Browser</div>
+            <div id=\"browserPath\" class=\"small\" style=\"margin:8px 0\"></div>
+            <div class=\"row-btn\">
+              <button id=\"btnBrowserUp\" data-i18n=\"btn_browser_up\">Up</button>
+              <button id=\"btnBrowserSelect\" data-i18n=\"btn_browser_select\">Select This Directory</button>
+              <button id=\"btnBrowserClose\" data-i18n=\"btn_browser_close\">Close</button>
+            </div>
+            <div id=\"browserList\" class=\"small\" style=\"margin-top:8px\"></div>
+          </div>
+          <label><span data-i18n=\"project_id\">Project ID</span><input id=\"projectId\" placeholder=\"my-project\" /></label>
+          <div class=\"row-btn\">
+            <button id=\"btnProjectAttach\" data-i18n=\"btn_project_attach\">Attach Project + Install Agent Rules</button>
+            <button id=\"btnProjectDetach\" data-i18n=\"btn_project_detach\">Detach Project</button>
+          </div>
+          <div class=\"small\" data-i18n=\"project_hint\">Attach will create .omnimem files and inject managed memory protocol blocks into AGENTS.md / CLAUDE.md / .cursorrules.</div>
+          <pre id=\"projectOut\" class=\"small\"></pre>
+        </div>
+      </div>
+    </div>
     <div id=\"memoryTab\" class=\"panel\">
       <div class=\"grid\">
         <div class=\"card wide\">
@@ -151,14 +183,20 @@ HTML_PAGE = """<!doctype html>
     const I18N = {
       en: {
         title: 'OmniMem WebUI', subtitle: 'Simple mode: Status & Actions / Configuration / Memory', language: 'Language',
-        tab_status: 'Status & Actions', tab_config: 'Configuration', tab_memory: 'Memory',
+        tab_status: 'Status & Actions', tab_config: 'Configuration', tab_project: 'Project Integration', tab_memory: 'Memory',
         system_status: 'System Status', actions: 'Actions',
         btn_status: 'Check Sync Status', btn_bootstrap: 'Bootstrap Device Sync', btn_push: 'Push', btn_pull: 'Pull',
         btn_daemon_on: 'Enable Daemon', btn_daemon_off: 'Disable Daemon',
         config_title: 'Configuration', cfg_path: 'Config Path', cfg_home: 'Home', cfg_markdown: 'Markdown Path', cfg_jsonl: 'JSONL Path', cfg_sqlite: 'SQLite Path', cfg_remote_name: 'Git Remote Name', cfg_remote_url: 'Git Remote URL', cfg_branch: 'Git Branch', btn_save: 'Save Configuration',
         mem_recent: 'Recent Memories', mem_hint: 'Click an ID to open full content', mem_content: 'Memory Content',
         th_id: 'ID', th_layer: 'Layer', th_kind: 'Kind', th_summary: 'Summary', th_updated: 'Updated At',
+        project_title: 'Project Integration', project_path: 'Project Path', project_id: 'Project ID',
+        btn_browse_project: 'Browse Directory', btn_use_cwd: 'Use Server CWD',
+        browser_title: 'Directory Browser', btn_browser_up: 'Up', btn_browser_select: 'Select This Directory', btn_browser_close: 'Close',
+        btn_project_attach: 'Attach Project + Install Agent Rules', btn_project_detach: 'Detach Project',
+        project_hint: 'Attach will create .omnimem files and inject managed memory protocol blocks into AGENTS.md / CLAUDE.md / .cursorrules.',
         cfg_saved: 'Configuration saved', cfg_failed: 'Save failed',
+        project_attach_ok: 'Project attached', project_detach_ok: 'Project detached', project_failed: 'Project action failed',
         init_ok: 'Config state: initialized', init_hint_ok: 'Daemon runs quasi-realtime sync in background (can be disabled).',
         init_missing: 'Config state: not initialized (save configuration first)', init_hint_missing: 'Daemon is disabled until configuration is initialized.',
         daemon_state: (d) => `Daemon: ${d.running ? 'running' : 'stopped'}, enabled=${d.enabled}, initialized=${d.initialized}`
@@ -272,6 +310,7 @@ HTML_PAGE = """<!doctype html>
     let currentLang = safeGetLang();
     if (!I18N[currentLang]) currentLang = 'en';
     let daemonCache = { running:false, enabled:false, initialized:false };
+    let browserPath = '';
     function t(key) {
       const dict = I18N[currentLang] || I18N.en;
@@ -363,6 +402,47 @@ HTML_PAGE = """<!doctype html>
       await loadDaemon();
     }
+    async function attachProject() {
+      const project_path = document.getElementById('projectPath').value.trim();
+      const project_id = document.getElementById('projectId').value.trim();
+      const out = document.getElementById('projectOut');
+      const d = await jpost('/api/project/attach', {project_path, project_id});
+      out.textContent = JSON.stringify(d, null, 2);
+      document.getElementById('status').innerHTML = d.ok ? `<span class=\"ok\">${t('project_attach_ok')}</span>` : `<span class=\"err\">${t('project_failed')}</span>`;
+    }
+    async function detachProject() {
+      const project_path = document.getElementById('projectPath').value.trim();
+      const out = document.getElementById('projectOut');
+      const d = await jpost('/api/project/detach', {project_path});
+      out.textContent = JSON.stringify(d, null, 2);
+      document.getElementById('status').innerHTML = d.ok ? `<span class=\"ok\">${t('project_detach_ok')}</span>` : `<span class=\"err\">${t('project_failed')}</span>`;
+    }
+    function escHtml(v) {
+      return String(v).replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('\"', '&quot;');
+    }
+    async function listDirs(path) {
+      const d = await jget('/api/fs/list?path=' + encodeURIComponent(path || ''));
+      if (!d.ok) {
+        document.getElementById('browserList').innerHTML = `<span class=\"err\">${escHtml(d.error || 'list failed')}</span>`;
+        return;
+      }
+      browserPath = d.path || '';
+      document.getElementById('browserPath').textContent = browserPath;
+      const rows = (d.items || [])
+        .map(x => `<div><a href=\"#\" data-path=\"${escHtml(x.path)}\">${escHtml(x.name)}/</a></div>`)
+        .join('');
+      document.getElementById('browserList').innerHTML = rows || '<span class=\"small\">(empty)</span>';
+      document.querySelectorAll('#browserList a').forEach(a => {
+        a.onclick = (e) => {
+          e.preventDefault();
+          listDirs(a.dataset.path || '');
+        };
+      });
+    }
     function bindTabs() {
       const btns = document.querySelectorAll('.tab-btn');
       btns.forEach(btn => {
@@ -389,6 +469,41 @@ HTML_PAGE = """<!doctype html>
       document.getElementById('btnSyncPull').onclick = () => runSync('github-pull');
       document.getElementById('btnDaemonOn').onclick = () => toggleDaemon(true);
       document.getElementById('btnDaemonOff').onclick = () => toggleDaemon(false);
+      document.getElementById('btnProjectAttach').onclick = () => attachProject();
+      document.getElementById('btnProjectDetach').onclick = () => detachProject();
+      document.getElementById('btnBrowseProject').onclick = async () => {
+        document.getElementById('browserPanel').style.display = 'block';
+        await listDirs(document.getElementById('projectPath').value.trim() || '');
+      };
+      document.getElementById('btnBrowserUp').onclick = async () => {
+        if (!browserPath) return;
+        const p = browserPath.replace(/\/+$/, '');
+        const i = p.lastIndexOf('/');
+        const up = i > 0 ? p.slice(0, i) : '/';
+        await listDirs(up);
+      };
+      document.getElementById('btnBrowserSelect').onclick = () => {
+        document.getElementById('projectPath').value = browserPath;
+        const pid = document.getElementById('projectId');
+        if (!pid.value.trim() && browserPath) {
+          const s = browserPath.replace(/\/+$/, '').split('/');
+          pid.value = s[s.length - 1] || 'project';
+        }
+      };
+      document.getElementById('btnBrowserClose').onclick = () => {
+        document.getElementById('browserPanel').style.display = 'none';
+      };
+      document.getElementById('btnUseCwd').onclick = async () => {
+        const d = await jget('/api/fs/cwd');
+        if (d.ok) {
+          document.getElementById('projectPath').value = d.cwd;
+          const pid = document.getElementById('projectId');
+          if (!pid.value.trim()) {
+            const s = d.cwd.replace(/\/+$/, '').split('/');
+            pid.value = s[s.length - 1] || 'project';
+          }
+        }
+      };
     }
     window.addEventListener('error', (e) => {
@@ -425,6 +540,137 @@ def _cfg_to_ui(cfg: dict[str, Any], cfg_path: Path) -> dict[str, Any]:
     }
+def _upsert_managed_block(path: Path, block: str) -> None:
+    start = "<!-- OMNIMEM:START -->"
+    end = "<!-- OMNIMEM:END -->"
+    managed = f"{start}\n{block.rstrip()}\n{end}\n"
+    if path.exists():
+        old = path.read_text(encoding="utf-8")
+        if start in old and end in old:
+            left = old.split(start, 1)[0].rstrip()
+            right = old.split(end, 1)[1].lstrip()
+            new_text = f"{left}\n\n{managed}"
+            if right:
+                new_text += f"\n{right}"
+            path.write_text(new_text, encoding="utf-8")
+            return
+        sep = "\n\n" if old and not old.endswith("\n\n") else ""
+        path.write_text(old + sep + managed, encoding="utf-8")
+        return
+    path.write_text(managed, encoding="utf-8")
+def _agent_protocol_block(project_id: str) -> str:
+    return (
+        "# OmniMem Memory Protocol\n"
+        "\n"
+        f"- Project ID: `{project_id}`\n"
+        "- Session start: run `omnimem brief --project-id <PROJECT_ID> --limit 8` and use it as active context.\n"
+        "- During task: when a stable decision/fact appears, run `omnimem write` with concise summary + evidence.\n"
+        "- Phase end: run `omnimem checkpoint` with goal/result/next-step/risks.\n"
+        "- If confidence is low or info is temporary, store in `instant`/`short`; promote to `long` only when repeated and stable.\n"
+        "- Never write raw secrets. Use credential references only (for example `op://...` or `env://...`).\n"
+    )
+def _attach_project_in_webui(project_path: str, project_id: str, cfg_home: str) -> dict[str, Any]:
+    if not project_path:
+        return {"ok": False, "error": "project_path is required"}
+    project = Path(project_path).expanduser().resolve()
+    if not project.exists() or not project.is_dir():
+        return {"ok": False, "error": f"project path not found: {project}"}
+    if not project_id:
+        project_id = project.name
+    repo_root = Path(__file__).resolve().parent.parent
+    tpl = repo_root / "templates" / "project-minimal"
+    created: list[str] = []
+    updated: list[str] = []
+    files = [
+        (tpl / ".omnimem.json", project / ".omnimem.json"),
+        (tpl / ".omnimem-session.md", project / ".omnimem-session.md"),
+        (tpl / ".omnimem-ignore", project / ".omnimem-ignore"),
+    ]
+    for src, dst in files:
+        text = src.read_text(encoding="utf-8")
+        text = text.replace("replace-with-project-id", project_id)
+        text = text.replace("~/.omnimem", cfg_home or "~/.omnimem")
+        exists = dst.exists()
+        dst.write_text(text, encoding="utf-8")
+        (updated if exists else created).append(str(dst))
+    block = _agent_protocol_block(project_id=project_id)
+    managed_targets = [
+        project / "AGENTS.md",
+        project / "CLAUDE.md",
+        project / ".cursorrules",
+    ]
+    for fp in managed_targets:
+        exists = fp.exists()
+        _upsert_managed_block(fp, block)
+        (updated if exists else created).append(str(fp))
+    cursor_rule = project / ".cursor" / "rules" / "omnimem.mdc"
+    cursor_exists = cursor_rule.exists()
+    cursor_rule.parent.mkdir(parents=True, exist_ok=True)
+    cursor_rule.write_text(
+        (
+            "---\n"
+            "description: OmniMem project memory protocol\n"
+            "alwaysApply: true\n"
+            "---\n\n"
+            + block
+        ),
+        encoding="utf-8",
+    )
+    (updated if cursor_exists else created).append(str(cursor_rule))
+    return {
+        "ok": True,
+        "project_path": str(project),
+        "project_id": project_id,
+        "created": created,
+        "updated": updated,
+    }
+def _detach_project_in_webui(project_path: str) -> dict[str, Any]:
+    if not project_path:
+        return {"ok": False, "error": "project_path is required"}
+    project = Path(project_path).expanduser().resolve()
+    if not project.exists() or not project.is_dir():
+        return {"ok": False, "error": f"project path not found: {project}"}
+    removed: list[str] = []
+    for name in [
+        ".omnimem.json",
+        ".omnimem-session.md",
+        ".omnimem-ignore",
+        ".cursorrules",
+        "CLAUDE.md",
+        "AGENTS.md",
+        ".cursor/rules/omnimem.mdc",
+    ]:
+        fp = project / name
+        if fp.exists():
+            txt = fp.read_text(encoding="utf-8", errors="ignore")
+            if "<!-- OMNIMEM:START -->" in txt and "<!-- OMNIMEM:END -->" in txt:
+                start = txt.index("<!-- OMNIMEM:START -->")
+                end = txt.index("<!-- OMNIMEM:END -->") + len("<!-- OMNIMEM:END -->")
+                new_txt = (txt[:start] + txt[end:]).strip()
+                if new_txt:
+                    fp.write_text(new_txt + "\n", encoding="utf-8")
+                else:
+                    fp.unlink()
+                removed.append(str(fp))
+                continue
+            if fp.name in {".omnimem.json", ".omnimem-session.md", ".omnimem-ignore", "omnimem.mdc"}:
+                fp.unlink()
+                removed.append(str(fp))
+    return {"ok": True, "project_path": str(project), "removed": removed}
 def run_webui(
     *,
     host: str,
@@ -516,6 +762,40 @@ def run_webui(
                 self._send_json({"ok": True, **daemon_state})
                 return
+            if parsed.path == "/api/fs/cwd":
+                self._send_json({"ok": True, "cwd": str(Path.cwd())})
+                return
+            if parsed.path == "/api/fs/list":
+                q = parse_qs(parsed.query)
+                raw_path = q.get("path", [""])[0].strip()
+                base = Path(raw_path).expanduser() if raw_path else Path.home()
+                try:
+                    p = base.resolve()
+                    if not p.exists() or not p.is_dir():
+                        self._send_json({"ok": False, "error": f"not a directory: {p}"}, 400)
+                        return
+                    items = []
+                    for child in sorted(p.iterdir(), key=lambda x: x.name.lower()):
+                        if child.is_dir() and not child.name.startswith("."):
+                            items.append({"name": child.name, "path": str(child)})
+                        if len(items) >= 200:
+                            break
+                    self._send_json({"ok": True, "path": str(p), "items": items})
+                except Exception as exc:  # pragma: no cover
+                    self._send_json({"ok": False, "error": str(exc)}, 500)
+                return
+            if parsed.path == "/api/project/defaults":
+                self._send_json(
+                    {
+                        "ok": True,
+                        "project_path": "",
+                        "project_id": "",
+                    }
+                )
+                return
             if parsed.path == "/api/memories":
                 q = parse_qs(parsed.query)
                 limit = int(q.get("limit", ["20"])[0])
@@ -612,6 +892,26 @@ def run_webui(
                 )
                 return
+            if parsed.path == "/api/project/attach":
+                try:
+                    out = _attach_project_in_webui(
+                        project_path=str(data.get("project_path", "")).strip(),
+                        project_id=str(data.get("project_id", "")).strip(),
+                        cfg_home=str(cfg.get("home", "")).strip(),
+                    )
+                    self._send_json(out, 200 if out.get("ok") else 400)
+                except Exception as exc:  # pragma: no cover
+                    self._send_json({"ok": False, "error": str(exc)}, 500)
+                return
+            if parsed.path == "/api/project/detach":
+                try:
+                    out = _detach_project_in_webui(str(data.get("project_path", "")).strip())
+                    self._send_json(out, 200 if out.get("ok") else 400)
+                except Exception as exc:  # pragma: no cover
+                    self._send_json({"ok": False, "error": str(exc)}, 500)
+                return
             self._send_json({"ok": False, "error": "not found"}, 404)
     server = ThreadingHTTPServer((host, port), Handler)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "omnimem",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": false,
   "description": "OmniMem CLI and bootstrap runner",
   "license": "MIT",

package/templates/project-minimal/.omnimem-session.md CHANGED Viewed

@@ -1,4 +1,4 @@
-# OmniMemory Session Entry
+# OmniMem Session Entry
 - Current phase:
 - Current objective:
@@ -8,6 +8,6 @@
 ## Quick start
-1. Run `omnimemory brief --project <project_id>`
+1. Run `omnimem brief --project-id <project_id>`
 2. Review top 3 recent checkpoints
 3. Continue task or start a new session

package/templates/project-minimal/.omnimem.json CHANGED Viewed

@@ -1,10 +1,10 @@
 {
   "version": "0.1.0",
   "project_id": "replace-with-project-id",
-  "memory_home": "~/.omnimemory",
+  "memory_home": "~/.omnimem",
   "default_tags": ["project:replace-with-project-id"],
   "collect": {
     "enabled": true,
-    "respect_ignore_file": ".omni-memory-ignore"
+    "respect_ignore_file": ".omnimem-ignore"
   }
 }