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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: universal-memory
-Version: 0.1.2
+Version: 0.1.4
 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
@@ -20,12 +20,13 @@ Requires-Dist: rich>=15.0.0
 Requires-Dist: tomli-w>=1.0.0
 Requires-Dist: typer>=0.9.0
 Requires-Python: >=3.12
-Project-URL: Homepage, https://github.com/YanAmorelli/universal-memory
+Project-URL: Homepage, https://universal-memory.com
+Project-URL: Documentation, https://docs.universal-memory.com
 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="https://docs.universal-memory.com/assets/umem-logo-transparent.png" alt="Universal Memory logo" width="720">
 </p>
 
 # Universal Memory (umem)
@@ -38,7 +39,7 @@ A vendor-agnostic cognitive persistence layer for AI agents. Eliminate the "repe
 
 To see the core idea visually, check out the [Excalidraw design](https://excalidraw.com/#json=j3XjQIWMYEnkIzHpypuBb,rNJaVOECDGZ3WSuEYcCDjQ) or the proposal structure:
 
-![Universal Memory MVP Proposal](docs/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
+![Universal Memory MVP Proposal](https://docs.universal-memory.com/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
 
 ### Diagram Breakdown
 
@@ -102,6 +103,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.4}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="assets/umem-logo.png" alt="Universal Memory logo" width="720">
+  <img src="https://docs.universal-memory.com/assets/umem-logo-transparent.png" alt="Universal Memory logo" width="720">
 </p>
 
 # Universal Memory (umem)
@@ -12,7 +12,7 @@ A vendor-agnostic cognitive persistence layer for AI agents. Eliminate the "repe
 
 To see the core idea visually, check out the [Excalidraw design](https://excalidraw.com/#json=j3XjQIWMYEnkIzHpypuBb,rNJaVOECDGZ3WSuEYcCDjQ) or the proposal structure:
 
-![Universal Memory MVP Proposal](docs/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
+![Universal Memory MVP Proposal](https://docs.universal-memory.com/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
 
 ### Diagram Breakdown
 
@@ -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.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "universal-memory"
-version = "0.1.2"
+version = "0.1.4"
 description = "Vendor-agnostic cognitive persistence layer for AI agents."
 readme = "README.md"
 license = { text = "MIT" }
@@ -40,7 +40,8 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/YanAmorelli/universal-memory"
+Homepage = "https://universal-memory.com"
+Documentation = "https://docs.universal-memory.com"
 Repository = "https://github.com/YanAmorelli/universal-memory"
 
 [project.scripts]
@@ -54,6 +55,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.4}/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.4"

{universal_memory-0.1.2 → universal_memory-0.1.4}/src/universal_memory/application/host/drift_detector.py

@@ -16,7 +16,7 @@ class InstructionDriftDetector:
             normalized = _normalize_line(claude_line)
             if normalized in agents_by_normalized:
                 warnings.append(
-                    "Instrucao duplicada em AGENTS.md e CLAUDE.md: "
+                    "Duplicate instruction in AGENTS.md and CLAUDE.md: "
                     f"{agents_by_normalized[normalized]}"
                 )
 
@@ -73,7 +73,8 @@ def _detect_always_never_contradictions(
         agents_polarity = _rule_polarity(agents_norm)
         if agents_polarity != claude_polarity:
             warnings.append(
-                f"Contradicao explicita entre AGENTS.md e CLAUDE.md: {agents_line} / {claude_line}"
+                f"Explicit contradiction between AGENTS.md and CLAUDE.md: "
+                f"{agents_line} / {claude_line}"
             )
     return warnings
 

{universal_memory-0.1.2 → universal_memory-0.1.4}/src/universal_memory/application/host/setup_host_use_case.py

@@ -176,7 +176,7 @@ def partition_instruction_blocks(
     for block in blocks:
         if UMEM_START in block.content or UMEM_END in block.content:
             raise ValidationFailedError(
-                f"O conteudo do bloco '{block.title}' nao pode conter os delimitadores UMEM."
+                f"Block '{block.title}' content cannot contain UMEM delimiters."
             )
 
         classification = block.resolved_classification
@@ -184,12 +184,10 @@ def partition_instruction_blocks(
             relative_path = block.relative_path or _canonical_doc_path(block.title, docs_directory)
             _safe_relative_path(relative_path)
             if relative_path in seen_paths:
-                raise ValidationFailedError(
-                    f"Caminho canonico duplicado detectado: {relative_path}"
-                )
+                raise ValidationFailedError(f"Duplicate canonical path detected: {relative_path}")
             seen_paths.add(relative_path)
             document = CanonicalDocument(
-                title=block.title.strip() or "Documento canônico",
+                title=block.title.strip() or "Canonical document",
                 content=block.content.strip(),
                 relative_path=relative_path,
             )
@@ -342,11 +340,11 @@ class ConfigureHostUseCase:
         try:
             path.relative_to(project_root_resolved)
         except ValueError:
-            failures.append("Falha de Arquivo de Instrução: caminho fora do projeto.")
+            failures.append("Instruction file failure: path is outside the project.")
             return self._host_read_validation_result(method, checks, failures)
 
         if not path.exists() or not path.is_file():
-            failures.append(f"Falha de Arquivo de Instrução: {target.relative_path} ausente.")
+            failures.append(f"Instruction file failure: {target.relative_path} is missing.")
             return self._host_read_validation_result(method, checks, failures)
 
         checks["instruction_file_exists"] = True
@@ -355,8 +353,7 @@ class ConfigureHostUseCase:
             content = path.read_text(encoding="utf-8")
         except (OSError, UnicodeDecodeError) as exc:
             failures.append(
-                f"Falha de Permissão de Leitura ou Escrita: não foi possível ler "
-                f"{target.relative_path}: {exc}"
+                f"Read or write permission failure: could not read {target.relative_path}: {exc}"
             )
             return self._host_read_validation_result(method, checks, failures)
 
@@ -369,8 +366,8 @@ class ConfigureHostUseCase:
             )
         except ValidationFailedError:
             failures.append(
-                f"Falha de Arquivo de Instrução: {target.relative_path} deve conter "
-                "delimitadores UMEM válidos."
+                f"Instruction file failure: {target.relative_path} must contain valid UMEM "
+                "delimiters."
             )
             return self._host_read_validation_result(method, checks, failures)
 
@@ -384,14 +381,14 @@ class ConfigureHostUseCase:
             )
             self._validate_no_raw_memory_dump(content, target_path=target.relative_path)
         except ValidationFailedError as exc:
-            failures.append(f"Falha de Arquivo de Instrução: {exc}")
+            failures.append(f"Instruction file failure: {exc}")
 
         inner_content = self._managed_block_inner_content(managed_block).strip()
         if inner_content:
             checks["managed_block_has_content"] = True
         else:
             failures.append(
-                f"Falha de Arquivo de Instrução: bloco UMEM em {target.relative_path} está vazio."
+                f"Instruction file failure: UMEM block in {target.relative_path} is empty."
             )
 
         if self._has_mcp_reference(inner_content):
@@ -399,8 +396,8 @@ class ConfigureHostUseCase:
             checks["mcp_configuration_documented_or_active"] = True
         else:
             failures.append(
-                "Falha de Configuração MCP: bloco UMEM não referencia universal-memory, "
-                "MCP/FastMCP ou comandos como umem context/status."
+                "MCP configuration failure: UMEM block does not reference universal-memory, "
+                "MCP/FastMCP, or commands such as umem context/status."
             )
 
         result = self._host_read_validation_result(method, checks, failures)
@@ -531,14 +528,16 @@ class ConfigureHostUseCase:
             target_name_val = getattr(target.name, "value", target.name)
             if classification_val not in supported:
                 warnings.append(
-                    f"Instrucao '{block.title}' com classificacao '{classification_val}' "
-                    f"foi ignorada pois nao e suportada pelo target {target_name_val}."
+                    f"Instruction '{block.title}' with classification '{classification_val}' "
+                    f"was ignored because target {target_name_val} does not support it."
                 )
 
         canonical_documents: list[CanonicalDocument] = []
         if target.name == InstructionTargetType.claude_md:
             if partition.canonical_documents:
-                raise ValidationFailedError("Host Claude Code nao suporta documentos canonicos.")
+                raise ValidationFailedError(
+                    "Claude Code host does not support canonical documents."
+                )
             managed_content = self._render_claude_managed_block(
                 self._target_manifest_blocks(
                     partition,
@@ -667,7 +666,7 @@ class ConfigureHostUseCase:
         try:
             host_name = HostName(host_id)
         except ValueError as exc:
-            raise ValidationFailedError(f"Host nao suportado: {host_id}") from exc
+            raise ValidationFailedError(f"Unsupported host: {host_id}") from exc
         timestamp = datetime.now(UTC)
         if host_name == HostName.claude_code:
             return Host(
@@ -696,7 +695,7 @@ class ConfigureHostUseCase:
                 audit_event_type="host_setup",
             )
         else:
-            raise ValidationFailedError(f"Host ainda nao suportado para setup: {host_id}")
+            raise ValidationFailedError(f"Host setup is not yet supported for: {host_id}")
 
     def _agents_md_target(self, host: Host) -> InstructionTarget:
         return self._instruction_target_for(host, InstructionTargetType.agents_md)
@@ -707,7 +706,9 @@ class ConfigureHostUseCase:
         target_type: InstructionTargetType,
     ) -> InstructionTarget:
         if host is not None and target_type not in host.supported_targets:
-            raise ValidationFailedError(f"Host {host.name.value} nao suporta {target_type.value}")
+            raise ValidationFailedError(
+                f"Host {host.name.value} does not support {target_type.value}"
+            )
         timestamp = datetime.now(UTC)
         if target_type == InstructionTargetType.claude_md:
             return InstructionTarget(
@@ -738,19 +739,19 @@ class ConfigureHostUseCase:
                 ],
             )
         else:
-            raise ValidationFailedError(f"Target nao suportado: {target_type.value}")
+            raise ValidationFailedError(f"Unsupported target: {target_type.value}")
 
     def _read_existing(self, relative_path: str) -> str:
         path = (self.project_root / relative_path).resolve()
         if not path.exists():
             return ""
         if not path.is_file():
-            raise ValidationFailedError(f"Caminho alvo nao e arquivo: {relative_path}")
+            raise ValidationFailedError(f"Target path is not a file: {relative_path}")
         try:
             path.relative_to(self.project_root)
         except ValueError as exc:
             raise ValidationFailedError(
-                "Caminho fora do diretorio do projeto nao permitido."
+                "Path outside the project directory is not allowed."
             ) from exc
         return path.read_text(encoding="utf-8")
 
@@ -771,6 +772,8 @@ class ConfigureHostUseCase:
             "> Read and follow `.umem/skills/use-universal-memory/SKILL.md`. If a relevant "
             "active skill exists, inspect it with "
             "`umem skills detail <skill-id-or-name> --format json` before acting.",
+            "> For repeated durable workflows, consider latent skill tracking via the UMEM guide; "
+            "do not track one-off work, raw evidence, secrets, or private data.",
             "> If `umem` is unavailable or not initialized, report that explicitly before "
             "continuing without external memory.",
             "> CRITICAL: proactively capture new memory or clean up outdated ones only when a "
@@ -800,7 +803,7 @@ class ConfigureHostUseCase:
             "fix, or decision was made. If so:",
             '1. Record: Proactively run `umem remember "Short fact." --scope project/global --tag <tag>` '
             "or `umem facts purge --id <id>` to remove outdated facts.",
-            "2. Propose Skills: Check `umem skills list` and run `umem skills propose` if recurring patterns exist.",
+            "2. Track Skills: For newly observed repeated workflows, run `umem skills track` with sanitized evidence; use `umem skills propose` only for existing latent candidates after approval.",
             "3. Sync: If you ran any mutation (remember or purge), run `umem host sync --apply` to bake it.",
             '4. Report: Append the UMEM status line `[UMEM: Remembered "..."]` or `[UMEM: No new facts/skills to record]` to your final output.',
             "",
@@ -848,6 +851,10 @@ class ConfigureHostUseCase:
                 "relevant active skill exists, inspect it with "
                 "`umem skills detail <skill-id-or-name> --format json` before acting."
             )
+            latent_skill_line = (
+                "> For repeated durable workflows, consider latent skill tracking via the UMEM guide; "
+                "do not track one-off work, raw evidence, secrets, or private data."
+            )
             unavailable_line = (
                 "> If `umem` is unavailable or not initialized, report that explicitly before "
                 "continuing without external memory."
@@ -885,6 +892,10 @@ class ConfigureHostUseCase:
                 "relevant active skill exists, inspect it with "
                 "`umem skills detail <skill-id-or-name> --format json` before acting."
             )
+            latent_skill_line = (
+                "> For repeated durable workflows, consider latent skill tracking via the UMEM guide; "
+                "do not track one-off work, raw evidence, secrets, or private data."
+            )
             unavailable_line = (
                 "> If `umem` is unavailable or not initialized, report that explicitly before "
                 "continuing without external memory."
@@ -912,6 +923,7 @@ class ConfigureHostUseCase:
             scope_line,
             memory_line,
             policy_line,
+            latent_skill_line,
             unavailable_line,
             recording_line,
             report_line,
@@ -940,7 +952,7 @@ class ConfigureHostUseCase:
                     "fix, or decision was made. If so:",
                     '1. Record: Proactively run `umem remember "Short fact." --scope project/global --tag <tag>` '
                     "or `umem facts purge --id <id>` to remove outdated facts.",
-                    "2. Propose Skills: Check `umem skills list` and run `umem skills propose` if recurring patterns exist.",
+                    "2. Track Skills: For newly observed repeated workflows, run `umem skills track` with sanitized evidence; use `umem skills propose` only for existing latent candidates after approval.",
                     "3. Sync: If you ran any mutation (remember or purge), run `umem host sync --apply` to bake it.",
                     '4. Report: Append the UMEM status line `[UMEM: Remembered "..."]` or `[UMEM: No new facts/skills to record]` to your final output.',
                     "",
@@ -1015,7 +1027,7 @@ class ConfigureHostUseCase:
         chars_count = len(content)
         if chars_count > max_chars or lines_count > max_lines:
             raise ValidationFailedError(
-                f"Manifesto {target_path} deve permanecer compacto; mova conteudo longo para docs/."
+                f"Manifest {target_path} must remain compact; move long content to docs/."
             )
 
     def _validate_no_raw_memory_dump(self, content: str, *, target_path: str = "AGENTS.md") -> None:
@@ -1027,15 +1039,15 @@ class ConfigureHostUseCase:
         )
         if json_fact_hits >= 2:  # noqa: PLR2004
             raise ValidationFailedError(
-                f"Manifesto {target_path} deve permanecer compacto e nao pode conter dump bruto "
-                "de fatos ou memorias."
+                f"Manifest {target_path} must remain compact and cannot contain raw fact or "
+                "memory dumps."
             )
 
         raw_fact_hits = len(re.findall(r"\b(?:raw memory fact|fact_id|source_fact_ids)\b", managed))
         if raw_fact_hits >= 5:  # noqa: PLR2004
             raise ValidationFailedError(
-                f"Manifesto {target_path} deve permanecer compacto e nao pode conter dump bruto "
-                "de fatos ou memorias."
+                f"Manifest {target_path} must remain compact and cannot contain raw fact or "
+                "memory dumps."
             )
 
     def _planned_changes(
@@ -1151,8 +1163,8 @@ def _canonical_doc_path(title: str, docs_directory: str) -> str:
 def _safe_relative_path(value: str) -> str:
     normalized = value.replace("\\", "/")
     if ":" in normalized or normalized.startswith("/") or not normalized:
-        raise ValidationFailedError("Caminho relativo invalido.")
+        raise ValidationFailedError("Invalid relative path.")
     path = PurePosixPath(normalized)
     if path.is_absolute() or ".." in path.parts:
-        raise ValidationFailedError("Caminho relativo invalido.")
+        raise ValidationFailedError("Invalid relative path.")
     return path.as_posix()

{universal_memory-0.1.2 → universal_memory-0.1.4}/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]:
@@ -345,7 +346,7 @@ class SyncInstructionsUseCase:
             return InstructionClassification(str(raw))
         except ValueError as exc:
             raise ValidationFailedError(
-                f"Classificacao de regra nao suportada para '{rule.name}': {raw}"
+                f"Unsupported rule classification for '{rule.name}': {raw}"
             ) from exc
 
     def _normalized_host_ids(self, host_ids: list[str] | None) -> list[str]:
@@ -356,10 +357,12 @@ class SyncInstructionsUseCase:
                 normalized.append(host_id)
         unsupported = [host_id for host_id in normalized if host_id not in DEFAULT_SYNC_HOSTS]
         if unsupported:
-            raise ValidationFailedError(f"Hosts nao suportados: {', '.join(unsupported)}")
+            raise ValidationFailedError(f"Unsupported hosts: {', '.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."
+                    f"Host '{host_id}' is not enabled in .umem/config.toml; enabling it "
+                    "automatically."
                 )
                 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:
@@ -391,20 +394,18 @@ class SyncInstructionsUseCase:
         try:
             loaded = load_config(self.project_root)
         except (OSError, InvalidConfigError, StorageError) as exc:
-            raise ValidationFailedError(f"Falha ao ler configuracao do projeto: {exc}") from exc
+            raise ValidationFailedError(f"Failed to read project configuration: {exc}") from exc
 
         raw_runtimes = loaded.merged.get("runtimes")
         if raw_runtimes is None:
             return None
         if not isinstance(raw_runtimes, dict):
-            raise ValidationFailedError("Configuracao invalida: runtimes deve ser uma tabela.")
+            raise ValidationFailedError("Invalid configuration: runtimes must be a table.")
         raw_enabled = raw_runtimes.get("enabled")
         if raw_enabled is None:
             return None
         if not isinstance(raw_enabled, list):
-            raise ValidationFailedError(
-                "Configuracao invalida: runtimes.enabled deve ser uma lista."
-            )
+            raise ValidationFailedError("Invalid configuration: runtimes.enabled must be a list.")
         enabled = [str(host_id) for host_id in raw_enabled]
         return [host_id for host_id in enabled if host_id in DEFAULT_SYNC_HOSTS]
 
@@ -420,7 +421,7 @@ class SyncInstructionsUseCase:
     def _manual_steps(self, results: list[Any], apply: bool) -> list[str]:
         steps: list[str] = []
         if not apply:
-            steps.append("Revise os caminhos afetados antes de aplicar.")
+            steps.append("Review affected paths before applying.")
         for result in results:
             for step in result.manual_steps:
                 if step not in steps:

{universal_memory-0.1.2 → universal_memory-0.1.4}/src/universal_memory/application/memory/get_memory_status_use_case.py

@@ -9,6 +9,7 @@ from pathlib import Path
 
 from universal_memory import __version__
 from universal_memory.domain.entities import (
+    AgentSkillStatus,
     AuditEventScope,
     FactScope,
     FactStatus,
@@ -17,6 +18,7 @@ from universal_memory.domain.entities import (
 )
 from universal_memory.domain.entities.base import format_utc_iso
 from universal_memory.domain.ports import (
+    AgentSkillRepository,
     AuditLogRepository,
     FactRepository,
     LatentSkillRepository,
@@ -52,6 +54,7 @@ class GetMemoryStatusUseCase:
         rule_repository: RuleRepository,
         latent_skill_repository: LatentSkillRepository,
         layout_port: ProjectLayoutPort,
+        agent_skill_repository: AgentSkillRepository | None = None,
         audit_log_repository: AuditLogRepository | None = None,
         data_root: Path | None = None,
         clock: Callable[[], datetime] = lambda: datetime.now(UTC),
@@ -59,6 +62,7 @@ class GetMemoryStatusUseCase:
         self.fact_repository = fact_repository
         self.rule_repository = rule_repository
         self.latent_skill_repository = latent_skill_repository
+        self.agent_skill_repository = agent_skill_repository
         self.layout_port = layout_port
         self.audit_log_repository = audit_log_repository
         self.data_root = data_root
@@ -79,10 +83,10 @@ class GetMemoryStatusUseCase:
                 approximate_size_bytes=0,
                 last_health_check=None,
                 host_validation={},
-                recommended_action="Execute 'umem init' a partir do diretorio raiz do projeto.",
+                recommended_action="Run 'umem init' from the project root directory.",
             )
 
-        # Diagnóstico de health check: verificar permissão de leitura/escrita
+        # Health check: verify read/write permissions.
         health_ok = True
         try:
             if not data_root.exists() or not os.access(data_root, os.R_OK | os.W_OK):
@@ -96,20 +100,25 @@ class GetMemoryStatusUseCase:
             fact_counts[fact.scope.value][fact.status.value] += 1
 
         active_rules = self.rule_repository.list(status=RuleStatus.active)
-        active_skills = self.latent_skill_repository.list(status=LatentSkillStatus.active)
+        registered_skills_count = self._registered_skills_count()
 
         return GetMemoryStatusResult(
             initialized=True,
             project_path=project_path,
             fact_counts=fact_counts,
             active_rules_count=len(active_rules),
-            registered_skills_count=len(active_skills),
+            registered_skills_count=registered_skills_count,
             approximate_size_bytes=_directory_size(data_root),
             last_health_check=format_utc_iso(self.clock()) if health_ok else None,
             host_validation=self._host_validation(),
             recommended_action=None,
         )
 
+    def _registered_skills_count(self) -> int:
+        if self.agent_skill_repository is not None:
+            return len(self.agent_skill_repository.list(status=AgentSkillStatus.active))
+        return len(self.latent_skill_repository.list(status=LatentSkillStatus.active))
+
     def _host_validation(self) -> dict[str, dict[str, str | None]]:
         unconfigured = {
             "claude_code": _unconfigured_host_validation(),

{universal_memory-0.1.2 → universal_memory-0.1.4}/src/universal_memory/application/memory/purge_fact_use_case.py

@@ -25,12 +25,10 @@ class PurgeFactUseCase:
 
     def execute(self, command: PurgeFactCommand) -> PurgeFactResult:
         if command.id is None and command.scope is None:
-            raise ValidationFailedError("Deve ser fornecido um id de fato ou um escopo para purga.")
+            raise ValidationFailedError("Provide either a fact ID or a scope to purge.")
 
         if command.id is not None and command.scope is not None:
-            raise ValidationFailedError(
-                "Nao e permitido fornecer simultaneamente id e escopo para purga."
-            )
+            raise ValidationFailedError("Provide either a fact ID or a scope to purge, not both.")
 
         if command.id is not None:
             fact = self.fact_repository.read(command.id)