universal-memory 0.1.2__tar.gz → 0.1.3__tar.gz

{universal_memory-0.1.2 → universal_memory-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: universal-memory
-Version: 0.1.2
+Version: 0.1.3
 Summary: Vendor-agnostic cognitive persistence layer for AI agents.
 Keywords: agent-memory,ai,ai-agents,agent-skills,claude-code,codex,context-engineering,developer-tools,llm,mcp,memory
 Author: Yan L. Amorelli
@@ -25,7 +25,7 @@ Project-URL: Repository, https://github.com/YanAmorelli/universal-memory
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="assets/umem-logo.png" alt="Universal Memory logo" width="720">
+  <img src="assets/umem-logo-transparent.png" alt="Universal Memory logo" width="720">
 </p>
 
 # Universal Memory (umem)
@@ -102,6 +102,34 @@ uvx --from universal-memory umem --help
 pip install universal-memory
 ```
 
+### Upgrade Universal Memory
+`umem update` does not upgrade the Python package from PyPI. It performs local, offline
+maintenance for the current `.umem` workspace, such as schema migrations, benchmark refreshes,
+and skill synchronization.
+
+To upgrade the installed `umem` executable, use the package manager that installed it:
+
+```bash
+# If installed with uv tool
+uv tool upgrade universal-memory
+
+# If installed with pipx
+pipx upgrade universal-memory
+
+# If installed with pip
+python -m pip install --upgrade universal-memory
+
+# If running temporarily with uvx
+uvx --refresh --from universal-memory umem --version
+```
+
+Confirm the executable you are running:
+
+```bash
+umem --version
+which umem
+```
+
 ---
 
 ## Quick Start Guide

{universal_memory-0.1.2 → universal_memory-0.1.3}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="assets/umem-logo.png" alt="Universal Memory logo" width="720">
+  <img src="assets/umem-logo-transparent.png" alt="Universal Memory logo" width="720">
 </p>
 
 # Universal Memory (umem)
@@ -76,6 +76,34 @@ uvx --from universal-memory umem --help
 pip install universal-memory
 ```
 
+### Upgrade Universal Memory
+`umem update` does not upgrade the Python package from PyPI. It performs local, offline
+maintenance for the current `.umem` workspace, such as schema migrations, benchmark refreshes,
+and skill synchronization.
+
+To upgrade the installed `umem` executable, use the package manager that installed it:
+
+```bash
+# If installed with uv tool
+uv tool upgrade universal-memory
+
+# If installed with pipx
+pipx upgrade universal-memory
+
+# If installed with pip
+python -m pip install --upgrade universal-memory
+
+# If running temporarily with uvx
+uvx --refresh --from universal-memory umem --version
+```
+
+Confirm the executable you are running:
+
+```bash
+umem --version
+which umem
+```
+
 ---
 
 ## Quick Start Guide

{universal_memory-0.1.2 → universal_memory-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "universal-memory"
-version = "0.1.2"
+version = "0.1.3"
 description = "Vendor-agnostic cognitive persistence layer for AI agents."
 readme = "README.md"
 license = { text = "MIT" }
@@ -54,6 +54,10 @@ dev = [
     "pytest>=8.0.0",
     "ruff>=0.3.0",
 ]
+docs = [
+    "mkdocs-material>=9.5.0",
+    "mkdocs>=1.6.0",
+]
 
 [build-system]
 requires = ["uv_build>=0.11.7,<0.12.0"]

{universal_memory-0.1.2 → universal_memory-0.1.3}/src/universal_memory/__init__.py

@@ -5,4 +5,4 @@ from importlib.metadata import PackageNotFoundError, version
 try:
     __version__ = version("universal-memory")
 except PackageNotFoundError:
-    __version__ = "0.1.2"
+    __version__ = "0.1.3"

{universal_memory-0.1.2 → universal_memory-0.1.3}/src/universal_memory/application/host/sync_instructions_use_case.py

@@ -95,7 +95,10 @@ class SyncInstructionsUseCase:
         )
         command = replace(command, max_managed_lines=max_lines, max_managed_chars=max_chars)
 
-        host_ids, config_warnings = self._host_ids_for_command(command.host_ids)
+        host_ids, config_warnings = self._host_ids_for_command(
+            command.host_ids,
+            apply=command.apply,
+        )
         all_blocks = self._active_rule_blocks()
         plans = self._plan_commands(host_ids, all_blocks, command)
 
@@ -306,8 +309,6 @@ class SyncInstructionsUseCase:
                     should_write_agents,
                 )
             )
-        if not plans and host_ids:
-            raise ValidationFailedError("Nenhum host suportado informado para sincronizacao.")
         return plans
 
     def _active_rule_blocks(self) -> list[InstructionBlock]:
@@ -359,7 +360,9 @@ class SyncInstructionsUseCase:
             raise ValidationFailedError(f"Hosts nao suportados: {', '.join(unsupported)}")
         return normalized
 
-    def _host_ids_for_command(self, host_ids: list[str] | None) -> tuple[list[str], list[str]]:
+    def _host_ids_for_command(
+        self, host_ids: list[str] | None, *, apply: bool
+    ) -> tuple[list[str], list[str]]:
         normalized = self._normalized_host_ids(host_ids)
         enabled_hosts = self._enabled_hosts_from_config()
         if enabled_hosts is None:
@@ -371,14 +374,14 @@ class SyncInstructionsUseCase:
         warnings = []
         to_enable = []
         for host_id in normalized:
-            if host_id not in enabled_hosts:
+            if host_id not in enabled_hosts and apply:
                 warnings.append(
                     f"Host '{host_id}' nao esta habilitado em .umem/config.toml; "
                     "ativando automaticamente."
                 )
                 to_enable.append(host_id)
 
-        if to_enable:
+        if to_enable and apply:
             new_enabled = list(enabled_hosts)
             for h in to_enable:
                 if h not in new_enabled: