MetaList 0.3.8__tar.gz → 0.3.10__tar.gz

{metalist-0.3.8/metalist.egg-info → metalist-0.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metalist
-Version: 0.3.8
+Version: 0.3.10
 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.8 → metalist-0.3.10}/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.8 → metalist-0.3.10}/app/services/namespace_switcher.py

@@ -45,6 +45,8 @@ _PROCESS_WAIT_POLL_INTERVAL_SECONDS = 0.25
 _TERMINATE_GRACE_SECONDS = 5.0
 _KILL_GRACE_SECONDS = 5.0
 _PROBE_TAB_ID = "namespace-switcher-probe"
+_LAUNCH_LOG_TAIL_BYTES = 16 * 1024
+ORCHESTRATED_CHILD_ENV_NAME = "METALIST_ORCHESTRATED_CHILD"
 
 
 @dataclass(frozen=True)
@@ -75,6 +77,12 @@ class NamespaceOpenResult:
     message: str
 
 
+@dataclass(frozen=True)
+class NamespaceLaunchProcess:
+    process: subprocess.Popen[bytes]
+    log_path: Path
+
+
 @dataclass(frozen=True)
 class NamespaceDeleteResult:
     deleted_namespace: str
@@ -301,7 +309,7 @@ def open_or_launch_namespace(
         chosen_profile=chosen_profile,
         allowed_listener_pids=frozenset(),
     )
-    _launch_namespace_process(
+    launched_process = _launch_namespace_process(
         environ=environ,
         chosen_profile=chosen_profile,
     )
@@ -309,6 +317,7 @@ def open_or_launch_namespace(
         environ=environ,
         namespace=normalized_namespace,
         port=chosen_profile.port,
+        launched_process=launched_process,
     )
     launched_url = _build_browser_url(environ=environ, port=chosen_profile.port)
     assert launched_url is not None
@@ -388,6 +397,23 @@ 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],
@@ -1500,7 +1526,7 @@ def _launch_namespace_process(
     *,
     environ: Mapping[str, str],
     chosen_profile: NamespaceLaunchProfile,
-) -> None:
+) -> NamespaceLaunchProcess:
     child_environ = dict(environ)
     for name in (
         "METALIST_NAMESPACE",
@@ -1510,6 +1536,7 @@ def _launch_namespace_process(
     ):
         if name in child_environ:
             del child_environ[name]
+    child_environ[ORCHESTRATED_CHILD_ENV_NAME] = "1"
     command = _resolve_main_launch_command(environ=child_environ)
     command.extend(
         [
@@ -1529,7 +1556,7 @@ def _launch_namespace_process(
     recycle_direct_append_log_file(path=log_path)
     log_handle = open(log_path, "ab")
     try:
-        subprocess.Popen(
+        process = subprocess.Popen(
             command,
             env=child_environ,
             stdout=log_handle,
@@ -1538,6 +1565,7 @@ def _launch_namespace_process(
         )
     finally:
         log_handle.close()
+    return NamespaceLaunchProcess(process=process, log_path=log_path)
 
 
 def _stop_processes_listening_on_port(*, port: int) -> None:
@@ -1567,7 +1595,7 @@ def _restart_running_namespace_process(
         allowed_listener_pids=allowed_listener_pids,
     )
     _stop_processes_listening_on_port(port=running_port)
-    _launch_namespace_process(
+    launched_process = _launch_namespace_process(
         environ=environ,
         chosen_profile=chosen_profile,
     )
@@ -1575,20 +1603,44 @@ def _restart_running_namespace_process(
         environ=environ,
         namespace=namespace,
         port=chosen_profile.port,
+        launched_process=launched_process,
     )
 
 
+def _read_namespace_launch_log_tail(*, log_path: Path) -> str:
+    read_capture = CapturedExceptionContext(OSError)
+    log_bytes: bytes | None = None
+    with read_capture:
+        log_bytes = log_path.read_bytes()
+    if read_capture.captured_exception is not None:
+        return f"<unable to read child log: {read_capture.captured_exception}>"
+    if log_bytes is None:
+        raise RuntimeError("Namespace child log read produced no bytes")
+    tail = log_bytes[-_LAUNCH_LOG_TAIL_BYTES:].decode("utf-8", errors="replace").strip()
+    if tail == "":
+        return "<child log is empty>"
+    return tail
+
+
 def _wait_for_namespace_ready(
     *,
     environ: Mapping[str, str],
     namespace: str,
     port: int,
+    launched_process: NamespaceLaunchProcess,
 ) -> None:
     main_server_config = resolve_main_server_config(environ=environ)
     connect_host = resolve_backend_connect_host(host=main_server_config.host)
     api_prefix = resolve_api_prefix(environ=environ)
     deadline = time.monotonic() + _LAUNCH_READY_TIMEOUT_SECONDS
     while time.monotonic() < deadline:
+        exit_code = launched_process.process.poll()
+        if exit_code is not None:
+            log_tail = _read_namespace_launch_log_tail(log_path=launched_process.log_path)
+            raise RuntimeError(
+                f"Namespace {namespace} process exited with code {exit_code}. "
+                f"Child log: {launched_process.log_path}\n{log_tail}"
+            )
         status_payload = _probe_namespace_status(
             host=connect_host,
             port=port,
@@ -1597,7 +1649,11 @@ def _wait_for_namespace_ready(
         if status_payload is not None and status_payload.get("namespace") == namespace:
             return
         time.sleep(_READY_POLL_INTERVAL_SECONDS)
-    raise RuntimeError(f"Timed out waiting for namespace {namespace} on port {port}")
+    log_tail = _read_namespace_launch_log_tail(log_path=launched_process.log_path)
+    raise RuntimeError(
+        f"Timed out waiting for namespace {namespace} on port {port}. "
+        f"Child log: {launched_process.log_path}\n{log_tail}"
+    )
 
 
 def _probe_namespace_status(

metalist-0.3.10/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.8 → metalist-0.3.10}/app/version.py

@@ -1,3 +1,3 @@
 """Single authoritative MetaList application version."""
 
-__version__ = "0.3.8"
+__version__ = "0.3.10"

{metalist-0.3.8 → metalist-0.3.10}/main.py

@@ -33,7 +33,9 @@ from app.startup_sanity import assert_startup_sanity
 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 ORCHESTRATED_CHILD_ENV_NAME
 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
@@ -775,7 +777,29 @@ def main(argv: list[str]) -> None:
 
 
 def cli() -> None:
-    main(sys.argv[1:])
+    argv = sys.argv[1:]
+    if ORCHESTRATED_CHILD_ENV_NAME in os.environ:
+        orchestrated_child = os.environ[ORCHESTRATED_CHILD_ENV_NAME]
+        if orchestrated_child != "1":
+            raise RuntimeError(f"{ORCHESTRATED_CHILD_ENV_NAME} must be '1' when set")
+        del os.environ[ORCHESTRATED_CHILD_ENV_NAME]
+        run_orchestrated_namespace_server(argv)
+        return
+    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:
@@ -787,6 +811,12 @@ def run_namespace_server(argv: list[str]) -> None:
     _run_namespace_server_for_current_env(argv=argv)
 
 
+def run_orchestrated_namespace_server(argv: list[str]) -> None:
+    logging.getLogger("uvicorn.access").addFilter(FilterCheckUpdates())
+    apply_main_cli_args_to_environ(argv=argv, environ=os.environ)
+    _run_namespace_server_for_current_env(argv=argv)
+
+
 def _run_namespace_server_for_current_env(*, argv: list[str]) -> None:
     database_runtime_config = resolve_database_runtime_config(
         environ=os.environ,

{metalist-0.3.8 → metalist-0.3.10/metalist.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metalist
-Version: 0.3.8
+Version: 0.3.10
 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.8 → metalist-0.3.10}/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