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

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

@@ -1,24 +1,25 @@
 Metadata-Version: 2.3
 Name: universal-memory
-Version: 0.1.4
+Version: 0.2.0
 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
 Author-email: Yan L. Amorelli <dev@amorelliaoyan.com>
-License: MIT
+License: Apache-2.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Dist: fastmcp>=0.1.0
-Requires-Dist: pydantic>=2.0
+Requires-Dist: fastmcp>=3.3.1,<4
+Requires-Dist: pydantic>=2.13.4,<3
 Requires-Dist: rich>=15.0.0
-Requires-Dist: tomli-w>=1.0.0
-Requires-Dist: typer>=0.9.0
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: typer>=0.25.1
 Requires-Python: >=3.12
 Project-URL: Homepage, https://universal-memory.com
 Project-URL: Documentation, https://docs.universal-memory.com
@@ -26,20 +27,22 @@ Project-URL: Repository, https://github.com/YanAmorelli/universal-memory
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="https://docs.universal-memory.com/assets/umem-logo-transparent.png" alt="Universal Memory logo" width="720">
+  <img src="docs/assets/umem-logo-lockup.svg" alt="UMem logo" width="720">
 </p>
 
-# Universal Memory (umem)
+# Universal Memory (UMem)
 
 [![PyPI version](https://img.shields.io/pypi/v/universal-memory.svg)](https://pypi.org/project/universal-memory/)
 [![Python Version](https://img.shields.io/pypi/pyversions/universal-memory.svg)](https://pypi.org/project/universal-memory/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/YanAmorelli/universal-memory/blob/dev/LICENSE)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/YanAmorelli/universal-memory/blob/dev/LICENSE)
+
+**[Website](https://universal-memory.com)** | **[Documentation](https://docs.universal-memory.com)**
 
 A vendor-agnostic cognitive persistence layer for AI agents. Eliminate the "repetition tax" by transporting your context, preferences, guidelines, and history seamlessly across sessions, IDEs, and LLM models.
 
 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](https://docs.universal-memory.com/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
+![Universal Memory MVP Proposal](docs/assets/diagrams/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
 
 ### Diagram Breakdown
 
@@ -61,7 +64,7 @@ Every time you open a new session in Claude Code, start a new chat in Cursor, sp
 * Copy-pasting database connection schemas or module layouts.
 * Explaining workflow methodologies (e.g., "We follow Spec-Driven Development (SDD)").
 
-Universal Memory acts as a local "Cognitive USB Drive" that automatically connects to your AI runtimes, aligning them to your exact workflow, context, and rules with zero friction.
+Universal Memory acts as a local persistence layer that automatically connects to your AI runtimes, aligning them to your exact workflow, context, and rules with zero friction.
 
 ---
 
@@ -78,7 +81,15 @@ Instead of copy-pasting instructions, `umem` monitors your session context and a
 Integrate `umem` natively with any client supporting the standard MCP (such as Claude Desktop or Cursor). AI agents can programmatically retrieve context, learn new facts, and suggest skills on the fly.
 
 ### 4. Agent Skills Standard
-Encapsulates complex, repetitive procedural instructions into formal Agent Skills (conforming to the [agentskills.io](https://agentskills.io) standard), complete with structured directories containing `SKILL.md` instructions, helper `scripts/`, and documentation `references/`.
+Encapsulates complex, repetitive procedural instructions into formal Agent Skills
+(conforming to the [agentskills.io](https://agentskills.io) standard), complete with
+structured directories containing `SKILL.md` instructions, helper `scripts/`, and
+documentation `references/`.
+
+Universal Memory treats `.umem/skills/<slug>/SKILL.md` as the canonical source of
+truth. Native runtime folders such as `.agents/skills/`, `.opencode/skills/`, and
+`.antigravity/rules/` receive complete synchronized copies so each agent can consume
+the same skill in its own expected layout.
 
 ---
 
@@ -158,7 +169,32 @@ Verify the consolidated context summary generated by combining short-term facts,
 umem context --scope project
 ```
 
-### 4. Check status and health
+### 4. Adopt or create an Agent Skill
+
+If a skill already exists in a native runtime directory, import it into UMEM and sync it
+back out to configured runtimes:
+
+```bash
+umem skills import .agents/skills/review-protocol --scope project --sync
+umem skills detail review-protocol
+```
+
+If you are starting from scratch, create the canonical skill first:
+
+```bash
+umem skills create \
+  --name "Review Protocol" \
+  --description "Reusable review workflow" \
+  --trigger "when reviewing code"
+```
+
+After editing `.umem/skills/review-protocol/SKILL.md`, refresh one runtime skill with:
+
+```bash
+umem skills sync review-protocol
+```
+
+### 5. Check status and health
 ```bash
 umem status
 ```
@@ -183,20 +219,26 @@ umem status
 
 AI agents can interact directly with your memory over the Model Context Protocol.
 
-### CLI Launch Command
+### One-off Launch Command
+```bash
+uvx --from universal-memory umem-mcp
+```
+
+### Persistent Install Launch Command
 ```bash
 umem-mcp
 ```
 
 ### Example Config: Claude Desktop (`claude_desktop_config.json`)
+Use the `uvx` form when Universal Memory is not installed as a persistent tool:
+
 ```json
 {
   "mcpServers": {
     "universal-memory": {
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "run",
-        "--package",
+        "--from",
         "universal-memory",
         "umem-mcp"
       ]
@@ -205,6 +247,29 @@ umem-mcp
 }
 ```
 
+If you installed Universal Memory with `uv tool install universal-memory` or `pipx install universal-memory`, use the stable entrypoint:
+
+```json
+{
+  "mcpServers": {
+    "universal-memory": {
+      "command": "umem-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+Troubleshoot startup with:
+
+```bash
+uvx --from universal-memory umem doctor
+uvx --from universal-memory umem-mcp --help
+```
+
+For GUI-launched MCP hosts, use the absolute path to `uvx` if the host does not inherit
+your shell `PATH`.
+
 ---
 
 ## Safety & Guardrails
@@ -218,26 +283,44 @@ umem-mcp
     # Revert last automated modification
     umem rollback --scope project
     ```
-*   **Update Conflict Warnings:** When updating canonical skills, if `umem` detects manual edits in local runtime rule directories (e.g. `.cursor/rules/sdd-rules.md`), it prompts you interactivelly to choose whether to keep your local edits or overwrite them, preventing workflow disruption.
+*   **Skill Drift Protection:** `umem skills sync` detects managed native drift and
+    keeps local changes by default. Use `--drift-decision overwrite` only when you
+    intentionally want canonical UMEM content to replace the managed native copy.
 
 ---
 
 ## Managing Agent Skills
 
-You can create, list, and sync specialized behaviors:
+You can create, import, list, inspect, and sync specialized behaviors:
 ```bash
 # List all active skills
 umem skills list
 
-# Synchronize skills into active native runtime folders
+# Inspect one skill
+umem skills detail review-protocol
+
+# Create a new canonical skill
+umem skills create --name "Review Protocol" --description "Reusable review workflow"
+
+# Adopt an existing native skill and distribute complete runtime copies
+umem skills import .agents/skills/review-protocol --scope project --sync
+
+# Synchronize one canonical skill into active native runtime folders
+umem skills sync review-protocol
+
+# Synchronize all active canonical skills during maintenance
 umem update --skills
 
-# Generate a new skill template from a latent skill proposal
-umem skills generate --name build-standard
+# Track and review recurring workflow candidates
+umem skills track --name "Review Protocol" --description "Recurring review workflow"
+umem skills recommend --scope project
+umem skills propose <latent-skill-id> --decision yes
+umem skills promote <recommendation-id> --yes
+umem skills generate <latent-skill-id> --yes
 ```
 
 ---
 
 ## License
 
-Distributed under the MIT License. See [LICENSE](LICENSE) for more information.
+Distributed under the Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE) for more information.

{universal_memory-0.1.4 → universal_memory-0.2.0}/README.md

@@ -1,18 +1,20 @@
 <p align="center">
-  <img src="https://docs.universal-memory.com/assets/umem-logo-transparent.png" alt="Universal Memory logo" width="720">
+  <img src="docs/assets/umem-logo-lockup.svg" alt="UMem logo" width="720">
 </p>
 
-# Universal Memory (umem)
+# Universal Memory (UMem)
 
 [![PyPI version](https://img.shields.io/pypi/v/universal-memory.svg)](https://pypi.org/project/universal-memory/)
 [![Python Version](https://img.shields.io/pypi/pyversions/universal-memory.svg)](https://pypi.org/project/universal-memory/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/YanAmorelli/universal-memory/blob/dev/LICENSE)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/YanAmorelli/universal-memory/blob/dev/LICENSE)
+
+**[Website](https://universal-memory.com)** | **[Documentation](https://docs.universal-memory.com)**
 
 A vendor-agnostic cognitive persistence layer for AI agents. Eliminate the "repetition tax" by transporting your context, preferences, guidelines, and history seamlessly across sessions, IDEs, and LLM models.
 
 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](https://docs.universal-memory.com/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
+![Universal Memory MVP Proposal](docs/assets/diagrams/UNIVERSAL-MEMORY-MVP-PROPOSAL.png)
 
 ### Diagram Breakdown
 
@@ -34,7 +36,7 @@ Every time you open a new session in Claude Code, start a new chat in Cursor, sp
 * Copy-pasting database connection schemas or module layouts.
 * Explaining workflow methodologies (e.g., "We follow Spec-Driven Development (SDD)").
 
-Universal Memory acts as a local "Cognitive USB Drive" that automatically connects to your AI runtimes, aligning them to your exact workflow, context, and rules with zero friction.
+Universal Memory acts as a local persistence layer that automatically connects to your AI runtimes, aligning them to your exact workflow, context, and rules with zero friction.
 
 ---
 
@@ -51,7 +53,15 @@ Instead of copy-pasting instructions, `umem` monitors your session context and a
 Integrate `umem` natively with any client supporting the standard MCP (such as Claude Desktop or Cursor). AI agents can programmatically retrieve context, learn new facts, and suggest skills on the fly.
 
 ### 4. Agent Skills Standard
-Encapsulates complex, repetitive procedural instructions into formal Agent Skills (conforming to the [agentskills.io](https://agentskills.io) standard), complete with structured directories containing `SKILL.md` instructions, helper `scripts/`, and documentation `references/`.
+Encapsulates complex, repetitive procedural instructions into formal Agent Skills
+(conforming to the [agentskills.io](https://agentskills.io) standard), complete with
+structured directories containing `SKILL.md` instructions, helper `scripts/`, and
+documentation `references/`.
+
+Universal Memory treats `.umem/skills/<slug>/SKILL.md` as the canonical source of
+truth. Native runtime folders such as `.agents/skills/`, `.opencode/skills/`, and
+`.antigravity/rules/` receive complete synchronized copies so each agent can consume
+the same skill in its own expected layout.
 
 ---
 
@@ -131,7 +141,32 @@ Verify the consolidated context summary generated by combining short-term facts,
 umem context --scope project
 ```
 
-### 4. Check status and health
+### 4. Adopt or create an Agent Skill
+
+If a skill already exists in a native runtime directory, import it into UMEM and sync it
+back out to configured runtimes:
+
+```bash
+umem skills import .agents/skills/review-protocol --scope project --sync
+umem skills detail review-protocol
+```
+
+If you are starting from scratch, create the canonical skill first:
+
+```bash
+umem skills create \
+  --name "Review Protocol" \
+  --description "Reusable review workflow" \
+  --trigger "when reviewing code"
+```
+
+After editing `.umem/skills/review-protocol/SKILL.md`, refresh one runtime skill with:
+
+```bash
+umem skills sync review-protocol
+```
+
+### 5. Check status and health
 ```bash
 umem status
 ```
@@ -156,20 +191,26 @@ umem status
 
 AI agents can interact directly with your memory over the Model Context Protocol.
 
-### CLI Launch Command
+### One-off Launch Command
+```bash
+uvx --from universal-memory umem-mcp
+```
+
+### Persistent Install Launch Command
 ```bash
 umem-mcp
 ```
 
 ### Example Config: Claude Desktop (`claude_desktop_config.json`)
+Use the `uvx` form when Universal Memory is not installed as a persistent tool:
+
 ```json
 {
   "mcpServers": {
     "universal-memory": {
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "run",
-        "--package",
+        "--from",
         "universal-memory",
         "umem-mcp"
       ]
@@ -178,6 +219,29 @@ umem-mcp
 }
 ```
 
+If you installed Universal Memory with `uv tool install universal-memory` or `pipx install universal-memory`, use the stable entrypoint:
+
+```json
+{
+  "mcpServers": {
+    "universal-memory": {
+      "command": "umem-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+Troubleshoot startup with:
+
+```bash
+uvx --from universal-memory umem doctor
+uvx --from universal-memory umem-mcp --help
+```
+
+For GUI-launched MCP hosts, use the absolute path to `uvx` if the host does not inherit
+your shell `PATH`.
+
 ---
 
 ## Safety & Guardrails
@@ -191,26 +255,44 @@ umem-mcp
     # Revert last automated modification
     umem rollback --scope project
     ```
-*   **Update Conflict Warnings:** When updating canonical skills, if `umem` detects manual edits in local runtime rule directories (e.g. `.cursor/rules/sdd-rules.md`), it prompts you interactivelly to choose whether to keep your local edits or overwrite them, preventing workflow disruption.
+*   **Skill Drift Protection:** `umem skills sync` detects managed native drift and
+    keeps local changes by default. Use `--drift-decision overwrite` only when you
+    intentionally want canonical UMEM content to replace the managed native copy.
 
 ---
 
 ## Managing Agent Skills
 
-You can create, list, and sync specialized behaviors:
+You can create, import, list, inspect, and sync specialized behaviors:
 ```bash
 # List all active skills
 umem skills list
 
-# Synchronize skills into active native runtime folders
+# Inspect one skill
+umem skills detail review-protocol
+
+# Create a new canonical skill
+umem skills create --name "Review Protocol" --description "Reusable review workflow"
+
+# Adopt an existing native skill and distribute complete runtime copies
+umem skills import .agents/skills/review-protocol --scope project --sync
+
+# Synchronize one canonical skill into active native runtime folders
+umem skills sync review-protocol
+
+# Synchronize all active canonical skills during maintenance
 umem update --skills
 
-# Generate a new skill template from a latent skill proposal
-umem skills generate --name build-standard
+# Track and review recurring workflow candidates
+umem skills track --name "Review Protocol" --description "Recurring review workflow"
+umem skills recommend --scope project
+umem skills propose <latent-skill-id> --decision yes
+umem skills promote <recommendation-id> --yes
+umem skills generate <latent-skill-id> --yes
 ```
 
 ---
 
 ## License
 
-Distributed under the MIT License. See [LICENSE](LICENSE) for more information.
+Distributed under the Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE) for more information.

{universal_memory-0.1.4 → universal_memory-0.2.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "universal-memory"
-version = "0.1.4"
+version = "0.2.0"
 description = "Vendor-agnostic cognitive persistence layer for AI agents."
 readme = "README.md"
-license = { text = "MIT" }
+license = { text = "Apache-2.0" }
 authors = [
     { name = "Yan L. Amorelli", email = "dev@amorelliaoyan.com" }
 ]
@@ -24,6 +24,7 @@ keywords = [
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.12",
@@ -32,11 +33,11 @@ classifiers = [
     "Topic :: Utilities",
 ]
 dependencies = [
-    "fastmcp>=0.1.0",
-    "pydantic>=2.0",
+    "fastmcp>=3.3.1,<4",
+    "pydantic>=2.13.4,<3",
     "rich>=15.0.0",
-    "tomli-w>=1.0.0",
-    "typer>=0.9.0",
+    "tomli-w>=1.2.0",
+    "typer>=0.25.1",
 ]
 
 [project.urls]
@@ -57,7 +58,7 @@ dev = [
 ]
 docs = [
     "mkdocs-material>=9.5.0",
-    "mkdocs>=1.6.0",
+    "mkdocs>=1.6.0,<2.0",
 ]
 
 [build-system]

{universal_memory-0.1.4 → universal_memory-0.2.0}/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.4"
+    __version__ = "0.2.0"

{universal_memory-0.1.4 → universal_memory-0.2.0}/src/universal_memory/application/onboarding/setup_project.py

@@ -621,6 +621,7 @@ CLI commands with `--format json` and MCP tools should return equivalent payload
 | Track skill | `umem skills track ... --format json` | `track_latent_skill(...)` |
 | Recommend skills | `umem skills recommend --scope project --format json` | `recommend_skills(scope="project", dry_run=true)` |
 | Propose skill | `umem skills propose <latent-skill-id> --decision yes --format json` | `propose_skill(latent_skill_id="<latent-skill-id>", decision="yes")` |
+| Promote skill recommendation | `umem skills promote <recommendation-id> --yes --format json` | `promote_skill_recommendation(recommendation_id="<recommendation-id>", confirm=true)` |
 | Generate skill | `umem skills generate <latent-skill-id> --yes --format json` | `generate_skill(latent_skill_id="<latent-skill-id>")` |
 | Activate skill | `umem skills activate <latent-skill-id> --format json` | `activate_skill(latent_skill_id="<latent-skill-id>")` |
 | Deactivate skill | `umem skills deactivate <latent-skill-id> --format json` | `deactivate_skill(latent_skill_id="<latent-skill-id>")` |

{universal_memory-0.1.4 → universal_memory-0.2.0}/src/universal_memory/bootstrap/mcp.py

@@ -1,60 +1,81 @@
 from __future__ import annotations
 
+import re
+import sys
+from collections.abc import Sequence
 from pathlib import Path
+from typing import TYPE_CHECKING
 
-from fastmcp import FastMCP
+if TYPE_CHECKING:
+    from fastmcp import FastMCP
 
-from universal_memory.application.diagnostics import DoctorUseCase
-from universal_memory.application.host import (
-    ConfigureHostUseCase,
-    SyncInstructionsUseCase,
+_SECRET_PATTERNS = (
+    re.compile(r"\b(?:sk|pk)-[A-Za-z0-9_-]{6,}\b"),
+    re.compile(r"\b[A-Za-z0-9_]*api[_-]?key[A-Za-z0-9_]*\s*[:=]\s*[^\s,;]+", re.IGNORECASE),
+    re.compile(r"\b[A-Za-z0-9_]*token[A-Za-z0-9_]*\s*[:=]\s*[^\s,;]+", re.IGNORECASE),
 )
-from universal_memory.application.memory import (
-    AssembleContextSummaryUseCase,
-    GetMemoryStatusUseCase,
-    ListFactsUseCase,
-    PurgeFactUseCase,
-    RememberFactUseCase,
-)
-from universal_memory.application.onboarding.setup_project import setup_project
-from universal_memory.application.security import (
-    ListAuditLogUseCase,
-    ListSnapshotsUseCase,
-    RollbackUseCase,
-    SafeWriteUseCase,
-)
-from universal_memory.application.skills import (
-    ActivateSkillUseCase,
-    CreateSkillUseCase,
-    DeactivateSkillUseCase,
-    GenerateSkillUseCase,
-    GetSkillDetailUseCase,
-    ImportSkillUseCase,
-    ListSkillsUseCase,
-    PromoteSkillRecommendationUseCase,
-    ProposeSkillUseCase,
-    RecommendSkillsUseCase,
-    SyncSkillsUseCase,
-    TrackLatentSkillUseCase,
-    UpdateSkillUseCase,
-)
-from universal_memory.infrastructure.config import LocalConfigValidationPort, LocalProjectLayoutPort
-from universal_memory.infrastructure.security import (
-    EntropySecretScanner,
-    LocalAuditLogRepository,
-    LocalSnapshotRepository,
-)
-from universal_memory.infrastructure.storage import (
-    LocalAgentSkillRepository,
-    LocalContextSummaryRepository,
-    LocalFactRepository,
-    LocalLatentSkillRepository,
-    LocalRuleRepository,
-)
-from universal_memory.interfaces.mcp import MCPUseCases, configure_server, create_mcp_server
+_UNIX_ABSOLUTE_PATH = re.compile(r"(?<![\w.-])/(?:[^/\s:]+/)+[^/\s:]+")
+_WINDOWS_ABSOLUTE_PATH = re.compile(r"(?<![\w.-])(?:[a-zA-Z]:\\|\\\\)(?:[^\\\s:]+\\)+[^\\\s:]+")
+_DEFAULT_RECOVERY_HINT = "Try again. If the problem persists, check the diagnostic logs."
 
 
-def build_server(project_root: Path | None = None) -> FastMCP:
+def build_server(project_root: Path | None = None) -> FastMCP:  # noqa: PLR0915
+    from universal_memory.application.diagnostics import DoctorUseCase  # noqa: PLC0415
+    from universal_memory.application.host import (  # noqa: PLC0415
+        ConfigureHostUseCase,
+        SyncInstructionsUseCase,
+    )
+    from universal_memory.application.memory import (  # noqa: PLC0415
+        AssembleContextSummaryUseCase,
+        GetMemoryStatusUseCase,
+        ListFactsUseCase,
+        PurgeFactUseCase,
+        RememberFactUseCase,
+    )
+    from universal_memory.application.onboarding.setup_project import setup_project  # noqa: PLC0415
+    from universal_memory.application.security import (  # noqa: PLC0415
+        ListAuditLogUseCase,
+        ListSnapshotsUseCase,
+        RollbackUseCase,
+        SafeWriteUseCase,
+    )
+    from universal_memory.application.skills import (  # noqa: PLC0415
+        ActivateSkillUseCase,
+        CreateSkillUseCase,
+        DeactivateSkillUseCase,
+        GenerateSkillUseCase,
+        GetSkillDetailUseCase,
+        ImportSkillUseCase,
+        ListSkillsUseCase,
+        PromoteSkillRecommendationUseCase,
+        ProposeSkillUseCase,
+        RecommendSkillsUseCase,
+        SyncSkillsUseCase,
+        TrackLatentSkillUseCase,
+        UpdateSkillUseCase,
+    )
+    from universal_memory.infrastructure.config import (  # noqa: PLC0415
+        LocalConfigValidationPort,
+        LocalProjectLayoutPort,
+    )
+    from universal_memory.infrastructure.security import (  # noqa: PLC0415
+        EntropySecretScanner,
+        LocalAuditLogRepository,
+        LocalSnapshotRepository,
+    )
+    from universal_memory.infrastructure.storage import (  # noqa: PLC0415
+        LocalAgentSkillRepository,
+        LocalContextSummaryRepository,
+        LocalFactRepository,
+        LocalLatentSkillRepository,
+        LocalRuleRepository,
+    )
+    from universal_memory.interfaces.mcp import (  # noqa: PLC0415
+        MCPUseCases,
+        configure_server,
+        create_mcp_server,
+    )
+
     try:
         root = project_root or Path.cwd()
     except Exception:
@@ -256,8 +277,63 @@ def build_server(project_root: Path | None = None) -> FastMCP:
     )
 
 
-def main() -> None:
-    build_server().run()
+def main(argv: Sequence[str] | None = None) -> None:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if any(arg in {"-h", "--help"} for arg in args):
+        print("Usage: umem-mcp [--help]")
+        print()
+        print("Run the Universal Memory MCP server over stdio.")
+        print("Troubleshoot environment issues with: umem doctor")
+        return
+
+    try:
+        build_server().run()
+    except Exception as error:
+        _write_startup_failure(error)
+        raise SystemExit(1) from None
+
+
+def _write_startup_failure(error: Exception) -> None:
+    lines = (
+        f"Universal Memory MCP startup failed: {_safe_error_detail(error)}",
+        f"Recovery hint: {_safe_recovery_hint(error)}",
+    )
+    try:
+        print(*lines, sep="\n", file=sys.stderr)
+    except OSError:
+        return
+
+
+def _safe_error_detail(error: Exception) -> str:
+    if isinstance(error, ImportError):
+        return _fallback_sanitize_error_detail(error)
+    try:
+        from universal_memory.interfaces.errors import sanitize_error_detail  # noqa: PLC0415
+
+        return sanitize_error_detail(error)
+    except Exception:
+        return _fallback_sanitize_error_detail(error)
+
+
+def _safe_recovery_hint(error: Exception) -> str:
+    try:
+        from universal_memory.interfaces.errors import recovery_hint  # noqa: PLC0415
+
+        return recovery_hint(error)
+    except Exception:
+        return _DEFAULT_RECOVERY_HINT
+
+
+def _fallback_sanitize_error_detail(error: Exception) -> str:
+    try:
+        detail = str(error)
+    except Exception:
+        return "Unexpected error."
+    detail = _UNIX_ABSOLUTE_PATH.sub("<path>", detail)
+    detail = _WINDOWS_ABSOLUTE_PATH.sub("<path>", detail)
+    for pattern in _SECRET_PATTERNS:
+        detail = pattern.sub("<secret>", detail)
+    return detail[:240] or "Unexpected error."
 
 
 if __name__ == "__main__":

{universal_memory-0.1.4 → universal_memory-0.2.0}/src/universal_memory/interfaces/cli/init_command.py

@@ -131,32 +131,16 @@ from universal_memory.interfaces.errors import (
 
 DEFAULT_CONTEXT_MAX_SIZE_CHARS = 4000
 AUDIT_REFERENCE_PLACEHOLDER = "not-implemented-yet"
-INIT_SPLASH_MARKER = "USB"
+INIT_SPLASH_MARKER = "UMem"
 INIT_SPLASH_LINES = (
-    "  umem",
-    " ┌───┐┌───────────────────────────────────────┐\n │USB├┤                  (o)                  ├┐\n └───┘└=======================================┘│\n                                               ┘",
-    " [USB] == portable memory for AI agents == ",
+    " _    _ __  __                \n"
+    "| |  | |  \\/  |               \n"
+    "| |  | | \\  / | ___ _ __ ___  \n"
+    "| |  | | |\\/| |/ _ \\ '_ ` _ \\ \n"
+    "| |__| | |  | |  __/ | | | | |\n"
+    " \\____/|_|  |_|\\___|_| |_| |_|",
+    "  persistent context for AI agents",
 )
-INIT_SPLASH_ANSI = """\x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m       \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[m
-\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m    \x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m     \x1b[38;5;255;48;5;255m▄\x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m    \x1b[m
-\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m     \x1b[38;5;255;48;5;255m▄\x1b[38;5;254;48;5;255m▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m     \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[38;5;255;48;5;254m▄\x1b[38;5;252;48;5;251m▄\x1b[38;5;188;48;5;188m▄\x1b[38;5;253;48;5;188m▄▄\x1b[38;5;254;48;5;253m▄▄\x1b[38;5;253;48;5;188m▄\x1b[38;5;254;48;5;253m▄▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;253;48;5;188m▄\x1b[38;5;253;48;5;253m▄▄▄▄▄▄\x1b[38;5;188;48;5;253m▄\x1b[38;5;253;48;5;253m▄▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[38;5;253;48;5;188m▄\x1b[38;5;252;48;5;253m▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;253;48;5;188m▄\x1b[38;5;253;48;5;253m▄▄▄\x1b[38;5;252;48;5;253m▄▄\x1b[38;5;254;48;5;254m▄\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m      \x1b[m
-\x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄\x1b[38;5;254;48;5;255m▄\x1b[38;5;188;48;5;252m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;252;48;5;252m▄\x1b[38;5;252;48;5;251m▄▄\x1b[38;5;252;48;5;252m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;252;48;5;252m▄\x1b[38;5;251;48;5;188m▄\x1b[38;5;7;48;5;252m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;252;48;5;251m▄▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;252;48;5;251m▄▄\x1b[38;5;251;48;5;251m▄▄\x1b[38;5;7;48;5;251m▄▄\x1b[38;5;250;48;5;252m▄\x1b[38;5;7;48;5;252m▄▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;252;48;5;251m▄\x1b[38;5;251;48;5;253m▄\x1b[38;5;7;48;5;252m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;250;48;5;252m▄\x1b[38;5;252;48;5;252m▄▄▄\x1b[38;5;7;48;5;252m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;252;48;5;251m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;251;48;5;253m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄\x1b[38;5;247;48;5;251m▄\x1b[38;5;248;48;5;7m▄\x1b[38;5;247;48;5;7m▄\x1b[38;5;102;48;5;250m▄\x1b[38;5;247;48;5;250m▄\x1b[38;5;247;48;5;7m▄▄\x1b[38;5;248;48;5;251m▄\x1b[38;5;188;48;5;188m▄\x1b[38;5;251;48;5;251m▄▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;251;48;5;7m▄▄\x1b[38;5;251;48;5;251m▄▄▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;246;48;5;251m▄\x1b[38;5;243;48;5;248m▄\x1b[38;5;246;48;5;250m▄\x1b[38;5;245;48;5;102m▄\x1b[38;5;247;48;5;243m▄\x1b[38;5;250;48;5;246m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;7;48;5;250m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;7;48;5;251m▄▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;252;48;5;251m▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;251;48;5;249m▄\x1b[38;5;250;48;5;249m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;7;48;5;251m▄▄▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;7;48;5;251m▄▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;254;48;5;188m▄\x1b[38;5;246;48;5;249m▄\x1b[38;5;253;48;5;255m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m ▄\x1b[48;5;255m    \x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄\x1b[38;5;247;48;5;247m▄▄▄\x1b[38;5;247;48;5;245m▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;246;48;5;247m▄\x1b[38;5;246;48;5;246m▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;250;48;5;252m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;243;48;5;251m▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;249;48;5;145m▄\x1b[38;5;7;48;5;245m▄\x1b[38;5;245;48;5;242m▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;250;48;5;145m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;248;48;5;242m▄\x1b[38;5;247;48;5;245m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;249;48;5;249m▄\x1b[38;5;250;48;5;145m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;145;48;5;251m▄\x1b[38;5;248;48;5;7m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;249;48;5;250m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;249;48;5;251m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;247;48;5;246m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[38;5;246;48;5;247m▄\x1b[38;5;247;48;5;246m▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;8;48;5;246m▄\x1b[38;5;246;48;5;246m▄\x1b[38;5;246;48;5;245m▄\x1b[38;5;246;48;5;246m▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;253;48;5;254m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;7;48;5;250m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;249;48;5;251m▄\x1b[38;5;249;48;5;250m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;145;48;5;7m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;250;48;5;249m▄\x1b[38;5;250;48;5;246m▄\x1b[38;5;243;48;5;248m▄\x1b[38;5;248;48;5;8m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;8;48;5;8m▄\x1b[38;5;243;48;5;240m▄\x1b[38;5;243;48;5;250m▄\x1b[38;5;246;48;5;145m▄\x1b[38;5;248;48;5;246m▄\x1b[38;5;251;48;5;145m▄\x1b[38;5;250;48;5;249m▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;250;48;5;249m▄▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;145;48;5;250m▄\x1b[38;5;7;48;5;249m▄\x1b[38;5;249;48;5;250m▄▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;251;48;5;7m▄\x1b[38;5;145;48;5;7m▄\x1b[38;5;145;48;5;249m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;249;48;5;249m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;254;48;5;254m▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;7;48;5;250m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[m
-\x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄\x1b[38;5;246;48;5;247m▄\x1b[38;5;247;48;5;247m▄▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;248;48;5;249m▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;247;48;5;246m▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;251;48;5;251m▄▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;251;48;5;252m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;249;48;5;250m▄\x1b[38;5;7;48;5;250m▄▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;7;48;5;7m▄\x1b[38;5;7;48;5;250m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;250;48;5;249m▄\x1b[38;5;7;48;5;246m▄\x1b[38;5;250;48;5;247m▄\x1b[38;5;247;48;5;242m▄\x1b[38;5;243;48;5;241m▄\x1b[38;5;246;48;5;241m▄\x1b[38;5;250;48;5;247m▄\x1b[38;5;250;48;5;7m▄▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;7;48;5;7m▄\x1b[48;5;250m \x1b[38;5;7;48;5;251m▄\x1b[38;5;7;48;5;250m▄▄▄\x1b[38;5;249;48;5;250m▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;249;48;5;251m▄\x1b[38;5;250;48;5;251m▄\x1b[38;5;250;48;5;249m▄\x1b[38;5;250;48;5;7m▄▄\x1b[38;5;250;48;5;249m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;251;48;5;255m▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;254;48;5;252m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄\x1b[48;5;255m    \x1b[m
-\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[38;5;255;48;5;254m▄\x1b[38;5;253;48;5;188m▄\x1b[38;5;188;48;5;251m▄\x1b[38;5;252;48;5;7m▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;251;48;5;249m▄\x1b[38;5;251;48;5;145m▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;7;48;5;7m▄▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;251;48;5;250m▄\x1b[38;5;249;48;5;249m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;249;48;5;250m▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;247;48;5;250m▄▄\x1b[38;5;248;48;5;251m▄\x1b[38;5;145;48;5;7m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;249;48;5;249m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;7;48;5;251m▄\x1b[38;5;251;48;5;251m▄\x1b[38;5;250;48;5;250m▄\x1b[38;5;145;48;5;248m▄\x1b[38;5;145;48;5;249m▄\x1b[38;5;145;48;5;248m▄\x1b[38;5;249;48;5;249m▄\x1b[38;5;247;48;5;250m▄\x1b[38;5;247;48;5;7m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;248;48;5;145m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;145;48;5;250m▄\x1b[38;5;145;48;5;249m▄\x1b[38;5;250;48;5;7m▄\x1b[38;5;249;48;5;251m▄\x1b[38;5;249;48;5;7m▄\x1b[38;5;248;48;5;7m▄\x1b[38;5;249;48;5;249m▄\x1b[38;5;145;48;5;250m▄\x1b[38;5;145;48;5;251m▄\x1b[38;5;249;48;5;250m▄\x1b[38;5;250;48;5;145m▄\x1b[38;5;252;48;5;248m▄\x1b[38;5;254;48;5;251m▄\x1b[38;5;254;48;5;254m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[m
-\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄\x1b[38;5;255;48;5;254m▄▄\x1b[38;5;255;48;5;253m▄▄\x1b[38;5;254;48;5;188m▄\x1b[38;5;254;48;5;253m▄\x1b[38;5;253;48;5;253m▄\x1b[38;5;248;48;5;251m▄\x1b[38;5;247;48;5;249m▄▄\x1b[38;5;247;48;5;145m▄▄\x1b[38;5;247;48;5;248m▄▄▄▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;247;48;5;248m▄▄\x1b[38;5;247;48;5;249m▄▄▄\x1b[38;5;248;48;5;145m▄\x1b[38;5;247;48;5;248m▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;248;48;5;247m▄▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;248;48;5;246m▄\x1b[38;5;145;48;5;247m▄▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;247;48;5;248m▄\x1b[38;5;145;48;5;249m▄\x1b[38;5;248;48;5;247m▄▄\x1b[38;5;248;48;5;246m▄▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;248;48;5;250m▄\x1b[38;5;248;48;5;248m▄\x1b[38;5;145;48;5;248m▄\x1b[38;5;248;48;5;248m▄▄\x1b[38;5;247;48;5;247m▄\x1b[38;5;248;48;5;247m▄\x1b[38;5;252;48;5;251m▄\x1b[38;5;255;48;5;254m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄▄▄\x1b[48;5;255m \x1b[m
-\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄\x1b[38;5;255;48;5;253m▄\x1b[38;5;254;48;5;252m▄▄\x1b[38;5;254;48;5;251m▄▄\x1b[38;5;253;48;5;251m▄▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[38;5;254;48;5;251m▄\x1b[38;5;254;48;5;252m▄▄\x1b[38;5;254;48;5;188m▄\x1b[38;5;255;48;5;254m▄\x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m  \x1b[m
-\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄\x1b[38;5;255;48;5;254m▄▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[38;5;255;48;5;255m▄\x1b[38;5;255;48;5;254m▄▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[38;5;255;48;5;255m▄▄\x1b[38;5;255;48;5;254m▄\x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m      \x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m \x1b[m
-\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m     \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[m
-\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[m
-\x1b[48;5;255m     \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄▄▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m       \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄▄\x1b[38;5;15;48;5;255m▄▄\x1b[48;5;255m  \x1b[m
-\x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m      \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄\x1b[48;5;255m        \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m   \x1b[38;5;255;48;5;255m▄\x1b[48;5;255m    \x1b[38;5;255;48;5;255m▄▄▄▄▄▄▄\x1b[48;5;255m  \x1b[38;5;255;48;5;255m▄▄▄\x1b[48;5;255m \x1b[m"""
 SetupProjectCommand = (
     Callable[[Path, list[str] | None], SetupProjectResult] | Callable[[Path], SetupProjectResult]
 )
@@ -1357,13 +1341,6 @@ def _ci_environment_enabled() -> bool:
     return value.strip().lower() not in {"", "0", "false", "no", "off"}
 
 
-def _terminal_color_enabled() -> bool:
-    if "NO_COLOR" in os.environ:
-        return False
-    term = os.environ.get("TERM", "")
-    return bool(term) and term != "dumb"
-
-
 def _should_render_init_splash(output_format: str) -> bool:
     return (
         output_format != "json"
@@ -1374,13 +1351,7 @@ def _should_render_init_splash(output_format: str) -> bool:
 
 
 def _render_init_splash() -> None:
-    if _terminal_color_enabled():
-        banner = (
-            f"\x1b[36m{INIT_SPLASH_LINES[0]}\x1b[0m\n{INIT_SPLASH_ANSI}\n{INIT_SPLASH_LINES[2]}\n"
-        )
-    else:
-        banner = "\n".join(INIT_SPLASH_LINES) + "\n"
-    sys.stdout.write(banner)
+    sys.stdout.write("\n".join(INIT_SPLASH_LINES) + "\n")
 
 
 def _confirm(prompt: str, default: bool = False) -> bool: