MetaList 0.3.7__tar.gz → 0.3.9__tar.gz

{metalist-0.3.7/metalist.egg-info → metalist-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metalist
-Version: 0.3.7
+Version: 0.3.9
 Summary: A minimalist single-user note-taking app with SSR, fast in-memory tree operations, and efficient sync.
 Project-URL: Homepage, https://github.com/evolvingstuff/metalist
 Project-URL: Repository, https://github.com/evolvingstuff/metalist
@@ -76,6 +76,12 @@ uv tool install metalist
 metalist
 ```
 
+After the first installation, update and restart MetaList with one cross-platform command:
+```bash
+metalist update
+```
+The updater stops running namespaces, hands off to an external PowerShell process on Windows or `/bin/sh` on macOS/Linux so the installed environment can unlock, runs the forced cache-refreshed uv update, and launches MetaList again.
+
 For pip, users can run `pip install metalist`. For a non-editable local install from this checkout, use `uv pip install .` or `pip install .` instead of the editable command below.
 
 ```bash
@@ -87,11 +93,11 @@ npm install
 ```
 
 ### Run
-The installed entrypoint starts Uvicorn with the FastAPI app:
+The installed entrypoint starts or restarts every known namespace, prints their URLs, and exits:
 ```bash
 metalist
 ```
-For source-checkout compatibility, `python main.py` still works. Plain `python main.py` is now an orchestration command: it restarts already-running namespaces from the current checkout, launches stopped namespaces, prints their URLs, and exits. Use `python main.py --namespace work` or `python main.py work` when you want one foreground namespace process.
+For source-checkout compatibility, `python main.py` performs the same orchestration. Use `metalist work`, `python main.py --namespace work`, or `python main.py work` when you want one foreground namespace process.
 
 `metalist` and explicit single-namespace source runs bind HTTP on `0.0.0.0:8000` by default, matching the old MetaList LAN-friendly behavior.
 On first startup, MetaList also auto-generates a self-signed TLS pair at `~/MetaList/certs/metalist-cert.pem` and `~/MetaList/certs/metalist-key.pem`, then enables HTTPS on `0.0.0.0:8443`. If you already have real PEM files, point `METALIST_TLS_CERT` and `METALIST_TLS_KEY` at them instead. Set `METALIST_AUTO_GENERATE_TLS=0` only if you explicitly want HTTP-only startup.
@@ -104,7 +110,7 @@ Database selection:
 - Launch precedence is: explicit CLI flags > env vars > saved namespace profile; if a namespace has no saved profile, launch it once with explicit ports or configure ports from the UI
 - Backups stay beside the namespace data under `~/MetaList/namespaces/work/backups/` and use one archive per snapshot with filenames like `work-<timestamp>.metalist-backup.tar.gz`
 - The Backup Settings modal targets one user-selected backup folder and can include multiple namespaces in a single run
-- Restoring `work` into `work` is the normal overwrite path; importing a backup under a different namespace name requires a new target namespace and rejects saved launch-port conflicts.
+- Restoring `work` into `work` is the normal overwrite path; importing a backup under a different namespace name can create a new target namespace with automatically selected conflict-free ports.
 
 Useful env flags:
 - `CRASH_SERVER_ON_FAIL=1` (default): fail-fast on validation errors

{metalist-0.3.7 → metalist-0.3.9}/README.md

@@ -47,6 +47,12 @@ uv tool install metalist
 metalist
 ```
 
+After the first installation, update and restart MetaList with one cross-platform command:
+```bash
+metalist update
+```
+The updater stops running namespaces, hands off to an external PowerShell process on Windows or `/bin/sh` on macOS/Linux so the installed environment can unlock, runs the forced cache-refreshed uv update, and launches MetaList again.
+
 For pip, users can run `pip install metalist`. For a non-editable local install from this checkout, use `uv pip install .` or `pip install .` instead of the editable command below.
 
 ```bash
@@ -58,11 +64,11 @@ npm install
 ```
 
 ### Run
-The installed entrypoint starts Uvicorn with the FastAPI app:
+The installed entrypoint starts or restarts every known namespace, prints their URLs, and exits:
 ```bash
 metalist
 ```
-For source-checkout compatibility, `python main.py` still works. Plain `python main.py` is now an orchestration command: it restarts already-running namespaces from the current checkout, launches stopped namespaces, prints their URLs, and exits. Use `python main.py --namespace work` or `python main.py work` when you want one foreground namespace process.
+For source-checkout compatibility, `python main.py` performs the same orchestration. Use `metalist work`, `python main.py --namespace work`, or `python main.py work` when you want one foreground namespace process.
 
 `metalist` and explicit single-namespace source runs bind HTTP on `0.0.0.0:8000` by default, matching the old MetaList LAN-friendly behavior.
 On first startup, MetaList also auto-generates a self-signed TLS pair at `~/MetaList/certs/metalist-cert.pem` and `~/MetaList/certs/metalist-key.pem`, then enables HTTPS on `0.0.0.0:8443`. If you already have real PEM files, point `METALIST_TLS_CERT` and `METALIST_TLS_KEY` at them instead. Set `METALIST_AUTO_GENERATE_TLS=0` only if you explicitly want HTTP-only startup.
@@ -75,7 +81,7 @@ Database selection:
 - Launch precedence is: explicit CLI flags > env vars > saved namespace profile; if a namespace has no saved profile, launch it once with explicit ports or configure ports from the UI
 - Backups stay beside the namespace data under `~/MetaList/namespaces/work/backups/` and use one archive per snapshot with filenames like `work-<timestamp>.metalist-backup.tar.gz`
 - The Backup Settings modal targets one user-selected backup folder and can include multiple namespaces in a single run
-- Restoring `work` into `work` is the normal overwrite path; importing a backup under a different namespace name requires a new target namespace and rejects saved launch-port conflicts.
+- Restoring `work` into `work` is the normal overwrite path; importing a backup under a different namespace name can create a new target namespace with automatically selected conflict-free ports.
 
 Useful env flags:
 - `CRASH_SERVER_ON_FAIL=1` (default): fail-fast on validation errors

{metalist-0.3.7 → metalist-0.3.9}/app/services/namespace_switcher.py

@@ -334,10 +334,33 @@ def open_or_launch_all_namespaces(
     if not isinstance(raw_namespaces, list):
         raise RuntimeError("Namespace catalog missing namespaces")
 
+    profiles = _resolve_conflict_free_profiles_for_all_namespaces(
+        raw_namespaces=raw_namespaces,
+    )
+    saved_profiles = _load_saved_profiles_by_namespace()
+    for profile in profiles:
+        saved_profile = saved_profiles.get(profile.namespace)
+        if saved_profile is None:
+            raise RuntimeError(f"Namespace {profile.namespace} launch profile disappeared")
+        if saved_profile == profile:
+            continue
+        save_namespace_launch_profile(
+            namespace=profile.namespace,
+            port=profile.port,
+            https_port=profile.https_port,
+            mcp_port=profile.mcp_port,
+        )
+        print(
+            f"[startup] WARNING: adjusted namespace {profile.namespace} ports to resolve "
+            f"a saved conflict: HTTP {saved_profile.port} -> {profile.port}, "
+            f"HTTPS {saved_profile.https_port} -> {profile.https_port}, "
+            f"MCP {saved_profile.mcp_port} -> {profile.mcp_port}.",
+            file=sys.stderr,
+            flush=True,
+        )
+
     results: list[NamespaceOpenResult] = []
-    for entry in raw_namespaces:
-        _assert_catalog_entry_has_launch_profile(entry=entry)
-        profile = _catalog_default_profile(entry=entry)
+    for profile in profiles:
         result = open_or_launch_namespace(
             environ=environ,
             current_namespace=None,
@@ -365,6 +388,91 @@ def open_or_launch_all_namespaces(
     return results
 
 
+def stop_all_namespace_processes_for_update() -> int:
+    profiles = _load_saved_profiles_by_namespace()
+    reserved_ports: set[int] = set()
+    for profile in profiles.values():
+        for _, port in _profile_service_ports(profile=profile):
+            reserved_ports.add(port)
+
+    listener_pids: set[int] = set()
+    for port in sorted(reserved_ports):
+        listener_pids.update(_find_listening_pids_for_port(port=port))
+    current_pid = os.getpid()
+    listener_pids.discard(current_pid)
+    for pid in sorted(listener_pids):
+        _stop_process(pid=pid)
+    return len(listener_pids)
+
+
+def _resolve_conflict_free_profiles_for_all_namespaces(
+    *,
+    raw_namespaces: Sequence[object],
+) -> list[NamespaceLaunchProfile]:
+    occupied_ports: set[int] = set()
+    profiles: list[NamespaceLaunchProfile] = []
+    for entry in raw_namespaces:
+        _assert_catalog_entry_has_launch_profile(entry=entry)
+        saved_profile = _catalog_default_profile(entry=entry)
+        profile = _repair_profile_port_conflicts(
+            profile=saved_profile,
+            occupied_ports=occupied_ports,
+        )
+        profiles.append(profile)
+        for _, port in _profile_service_ports(profile=profile):
+            occupied_ports.add(port)
+    return profiles
+
+
+def _repair_profile_port_conflicts(
+    *,
+    profile: NamespaceLaunchProfile,
+    occupied_ports: set[int],
+) -> NamespaceLaunchProfile:
+    working_ports = set(occupied_ports)
+    http_port = _keep_or_replace_port(
+        preferred_port=profile.port,
+        replacement_start=server_runtime._DEFAULT_HTTP_PORT,
+        occupied_ports=working_ports,
+    )
+    working_ports.add(http_port)
+
+    https_port = profile.https_port
+    if https_port is not None:
+        https_port = _keep_or_replace_port(
+            preferred_port=https_port,
+            replacement_start=server_runtime._DEFAULT_HTTPS_PORT,
+            occupied_ports=working_ports,
+        )
+        working_ports.add(https_port)
+
+    mcp_port = _keep_or_replace_port(
+        preferred_port=profile.mcp_port,
+        replacement_start=server_runtime._DEFAULT_MCP_AGENT_WEB_PORT,
+        occupied_ports=working_ports,
+    )
+    return NamespaceLaunchProfile(
+        namespace=profile.namespace,
+        port=http_port,
+        https_port=https_port,
+        mcp_port=mcp_port,
+    )
+
+
+def _keep_or_replace_port(
+    *,
+    preferred_port: int,
+    replacement_start: int,
+    occupied_ports: set[int],
+) -> int:
+    if preferred_port not in occupied_ports:
+        return preferred_port
+    return _next_free_port(
+        start_port=replacement_start,
+        occupied_ports=occupied_ports,
+    )
+
+
 def save_namespace_port_profiles(
     *,
     environ: Mapping[str, str],

metalist-0.3.9/app/services/self_update.py

@@ -0,0 +1,167 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from dataclasses import dataclass
+import os
+from pathlib import Path
+import shlex
+import shutil
+import subprocess
+
+from app.services.namespace_switcher import stop_all_namespace_processes_for_update
+
+
+_WINDOWS_CREATE_NEW_CONSOLE = 0x00000010
+
+
+@dataclass(frozen=True)
+class SelfUpdateScheduleResult:
+    stopped_process_count: int
+    platform_name: str
+    message: str
+
+
+def schedule_self_update(
+    *,
+    metalist_executable: str,
+    current_pid: int,
+    platform_name: str,
+    environ: Mapping[str, str],
+) -> SelfUpdateScheduleResult:
+    _validate_schedule_inputs(
+        metalist_executable=metalist_executable,
+        current_pid=current_pid,
+        platform_name=platform_name,
+    )
+    uv_executable = shutil.which("uv")
+    if uv_executable is None:
+        raise RuntimeError("uv executable was not found on PATH; MetaList was not stopped")
+
+    updater_command: list[str]
+    updater_options: dict[str, object]
+    if platform_name == "win32":
+        powershell_executable = _resolve_windows_powershell()
+        updater_command = _build_windows_updater_command(
+            powershell_executable=powershell_executable,
+            uv_executable=uv_executable,
+            metalist_executable=metalist_executable,
+            current_pid=current_pid,
+        )
+        updater_options = {
+            "creationflags": _WINDOWS_CREATE_NEW_CONSOLE,
+            "cwd": str(Path.home()),
+            "env": dict(environ),
+        }
+    else:
+        shell_path = Path("/bin/sh")
+        if not shell_path.is_file():
+            raise RuntimeError("/bin/sh is required for MetaList self-update; MetaList was not stopped")
+        updater_command = _build_posix_updater_command(
+            shell_executable=str(shell_path),
+            uv_executable=uv_executable,
+            metalist_executable=metalist_executable,
+            current_pid=current_pid,
+        )
+        updater_options = {
+            "start_new_session": True,
+            "cwd": str(Path.home()),
+            "env": dict(environ),
+        }
+
+    stopped_process_count = stop_all_namespace_processes_for_update()
+    subprocess.Popen(updater_command, **updater_options)
+    return SelfUpdateScheduleResult(
+        stopped_process_count=stopped_process_count,
+        platform_name=platform_name,
+        message=(
+            f"Stopped {stopped_process_count} MetaList process(es). "
+            "The updater will install the latest release and restart MetaList."
+        ),
+    )
+
+
+def _validate_schedule_inputs(
+    *,
+    metalist_executable: str,
+    current_pid: int,
+    platform_name: str,
+) -> None:
+    if not isinstance(metalist_executable, str) or metalist_executable.strip() == "":
+        raise ValueError("metalist_executable must be a non-empty string")
+    if not isinstance(current_pid, int) or current_pid <= 0:
+        raise ValueError("current_pid must be a positive integer")
+    if platform_name not in {"darwin", "linux", "win32"}:
+        raise RuntimeError(f"MetaList self-update does not support platform: {platform_name}")
+
+
+def _resolve_windows_powershell() -> str:
+    powershell_executable = shutil.which("powershell.exe")
+    if powershell_executable is not None:
+        return powershell_executable
+    pwsh_executable = shutil.which("pwsh.exe")
+    if pwsh_executable is not None:
+        return pwsh_executable
+    raise RuntimeError("PowerShell is required for MetaList self-update; MetaList was not stopped")
+
+
+def _quote_powershell_literal(value: str) -> str:
+    return "'" + value.replace("'", "''") + "'"
+
+
+def _build_windows_updater_command(
+    *,
+    powershell_executable: str,
+    uv_executable: str,
+    metalist_executable: str,
+    current_pid: int,
+) -> list[str]:
+    quoted_uv = _quote_powershell_literal(uv_executable)
+    quoted_metalist = _quote_powershell_literal(metalist_executable)
+    script = (
+        f"while (Get-Process -Id {current_pid} -ErrorAction SilentlyContinue) "
+        "{ Start-Sleep -Milliseconds 100 }; "
+        f"& {quoted_uv} tool install --force --reinstall --refresh metalist; "
+        "if ($LASTEXITCODE -ne 0) { "
+        "Write-Host 'MetaList update failed. Review the uv output above.' -ForegroundColor Red; "
+        "Start-Sleep -Seconds 10; exit $LASTEXITCODE }; "
+        f"& {quoted_metalist}; "
+        "if ($LASTEXITCODE -ne 0) { "
+        "Write-Host 'MetaList updated, but restart failed.' -ForegroundColor Red; "
+        "Start-Sleep -Seconds 10; exit $LASTEXITCODE }; "
+        "Write-Host 'MetaList update complete.' -ForegroundColor Green; "
+        "Start-Sleep -Seconds 3"
+    )
+    return [
+        powershell_executable,
+        "-NoLogo",
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        script,
+    ]
+
+
+def _build_posix_updater_command(
+    *,
+    shell_executable: str,
+    uv_executable: str,
+    metalist_executable: str,
+    current_pid: int,
+) -> list[str]:
+    uv_command = shlex.join(
+        [uv_executable, "tool", "install", "--force", "--reinstall", "--refresh", "metalist"]
+    )
+    metalist_command = shlex.join([metalist_executable])
+    script = (
+        f"while kill -0 {current_pid} 2>/dev/null; do sleep 0.1; done\n"
+        f"if ! {uv_command}; then\n"
+        "  echo 'MetaList update failed. Review the uv output above.' >&2\n"
+        "  exit 1\n"
+        "fi\n"
+        f"if ! {metalist_command}; then\n"
+        "  echo 'MetaList updated, but restart failed.' >&2\n"
+        "  exit 1\n"
+        "fi\n"
+        "echo 'MetaList update complete.'\n"
+    )
+    return [shell_executable, "-c", script]

{metalist-0.3.7 → metalist-0.3.9}/app/version.py

@@ -1,3 +1,3 @@
 """Single authoritative MetaList application version."""
 
-__version__ = "0.3.7"
+__version__ = "0.3.9"

{metalist-0.3.7 → metalist-0.3.9}/main.py

@@ -34,6 +34,7 @@ from app.services.exception_capture import CapturedExceptionContext
 from app.services.namespace_switcher import build_namespace_catalog
 from app.services.namespace_switcher import NamespaceOpenResult
 from app.services.namespace_switcher import open_or_launch_all_namespaces
+from app.services.self_update import schedule_self_update
 from app.services.windows_process_control import find_listening_pids_for_port as find_windows_listening_pids_for_port
 from app.services.windows_process_control import is_process_running as is_windows_process_running
 from app.services.windows_process_control import stop_process as stop_windows_process
@@ -155,8 +156,6 @@ def _should_bootstrap_all_namespaces_without_cli_parse(
 ) -> bool:
     if len(argv) != 0:
         return False
-    if not _is_source_main_entrypoint():
-        return False
     if "TEST_MODE" in original_environ and original_environ["TEST_MODE"] == "1":
         return False
     return not any(name in original_environ for name in _EXPLICIT_NAMESPACE_LAUNCH_ENV_NAMES)
@@ -777,8 +776,22 @@ def main(argv: list[str]) -> None:
 
 
 def cli() -> None:
-    _bootstrap_default_namespace_if_empty(environ=os.environ)
-    main([])
+    argv = sys.argv[1:]
+    if len(argv) != 0 and argv[0] == "update":
+        if argv != ["update"]:
+            raise RuntimeError("Usage: metalist update")
+        metalist_executable = _resolve_current_entrypoint()
+        if metalist_executable is None:
+            raise RuntimeError("Could not resolve the installed MetaList executable")
+        result = schedule_self_update(
+            metalist_executable=metalist_executable,
+            current_pid=os.getpid(),
+            platform_name=sys.platform,
+            environ=os.environ,
+        )
+        print(result.message)
+        return
+    main(argv)
 
 
 def run_namespace_server(argv: list[str]) -> None:

{metalist-0.3.7 → metalist-0.3.9/metalist.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metalist
-Version: 0.3.7
+Version: 0.3.9
 Summary: A minimalist single-user note-taking app with SSR, fast in-memory tree operations, and efficient sync.
 Project-URL: Homepage, https://github.com/evolvingstuff/metalist
 Project-URL: Repository, https://github.com/evolvingstuff/metalist
@@ -76,6 +76,12 @@ uv tool install metalist
 metalist
 ```
 
+After the first installation, update and restart MetaList with one cross-platform command:
+```bash
+metalist update
+```
+The updater stops running namespaces, hands off to an external PowerShell process on Windows or `/bin/sh` on macOS/Linux so the installed environment can unlock, runs the forced cache-refreshed uv update, and launches MetaList again.
+
 For pip, users can run `pip install metalist`. For a non-editable local install from this checkout, use `uv pip install .` or `pip install .` instead of the editable command below.
 
 ```bash
@@ -87,11 +93,11 @@ npm install
 ```
 
 ### Run
-The installed entrypoint starts Uvicorn with the FastAPI app:
+The installed entrypoint starts or restarts every known namespace, prints their URLs, and exits:
 ```bash
 metalist
 ```
-For source-checkout compatibility, `python main.py` still works. Plain `python main.py` is now an orchestration command: it restarts already-running namespaces from the current checkout, launches stopped namespaces, prints their URLs, and exits. Use `python main.py --namespace work` or `python main.py work` when you want one foreground namespace process.
+For source-checkout compatibility, `python main.py` performs the same orchestration. Use `metalist work`, `python main.py --namespace work`, or `python main.py work` when you want one foreground namespace process.
 
 `metalist` and explicit single-namespace source runs bind HTTP on `0.0.0.0:8000` by default, matching the old MetaList LAN-friendly behavior.
 On first startup, MetaList also auto-generates a self-signed TLS pair at `~/MetaList/certs/metalist-cert.pem` and `~/MetaList/certs/metalist-key.pem`, then enables HTTPS on `0.0.0.0:8443`. If you already have real PEM files, point `METALIST_TLS_CERT` and `METALIST_TLS_KEY` at them instead. Set `METALIST_AUTO_GENERATE_TLS=0` only if you explicitly want HTTP-only startup.
@@ -104,7 +110,7 @@ Database selection:
 - Launch precedence is: explicit CLI flags > env vars > saved namespace profile; if a namespace has no saved profile, launch it once with explicit ports or configure ports from the UI
 - Backups stay beside the namespace data under `~/MetaList/namespaces/work/backups/` and use one archive per snapshot with filenames like `work-<timestamp>.metalist-backup.tar.gz`
 - The Backup Settings modal targets one user-selected backup folder and can include multiple namespaces in a single run
-- Restoring `work` into `work` is the normal overwrite path; importing a backup under a different namespace name requires a new target namespace and rejects saved launch-port conflicts.
+- Restoring `work` into `work` is the normal overwrite path; importing a backup under a different namespace name can create a new target namespace with automatically selected conflict-free ports.
 
 Useful env flags:
 - `CRASH_SERVER_ON_FAIL=1` (default): fail-fast on validation errors

{metalist-0.3.7 → metalist-0.3.9}/metalist.egg-info/SOURCES.txt

@@ -114,6 +114,7 @@ app/services/search_history.py
 app/services/search_index.py
 app/services/search_query.py
 app/services/search_text.py
+app/services/self_update.py
 app/services/session_timeout_service.py
 app/services/shell_session_service.py
 app/services/snapshot.py