progi 0.1.0__py3-none-any.whl

progi/__init__.py

@@ -0,0 +1,3 @@
+"""progi — an MCP server with an optional web UI over a shared SQLite database."""
+
+__version__ = "0.1.0"

progi/cli.py

@@ -0,0 +1,80 @@
+"""Command-line entry point for `progi`.
+
+Run modes
+---------
+  progi               -> MCP server (stdio) + web UI (background thread)
+  progi --no-web      -> MCP server only
+  progi-web           -> web UI only (separate entry point, see web.app:main)
+
+Why the web server runs in a background daemon thread in bundled mode:
+the MCP server speaks the protocol over stdout and must run in the foreground.
+uvicorn is started on a separate thread with logging pinned to stderr so it
+never writes to stdout and corrupts the MCP stream. The thread is a daemon, so
+it exits when the MCP server (foreground) exits.
+
+Flags override environment variables; environment variables override defaults.
+"""
+
+from __future__ import annotations
+
+import argparse
+import threading
+
+from . import mcp_server
+from .config import Config, load_config
+from .logging_setup import configure_logging
+
+
+def _start_web_in_thread(cfg: Config) -> threading.Thread:
+    import uvicorn
+
+    from .web.app import app
+
+    app.state.cfg = cfg
+    server = uvicorn.Server(
+        uvicorn.Config(
+            app,
+            host=cfg.web_host,
+            port=cfg.web_port,
+            # Keep uvicorn quiet on stdout; warnings/errors go to stderr via our
+            # logging config. log_config=None prevents uvicorn from installing
+            # its own stdout handlers.
+            log_config=None,
+            log_level="warning",
+        )
+    )
+    thread = threading.Thread(target=server.run, name="progi-web", daemon=True)
+    thread.start()
+    return thread
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="progi", description="progi MCP server + web UI")
+    parser.add_argument(
+        "--no-web",
+        action="store_true",
+        help="Run only the MCP server (skip the web UI).",
+    )
+    parser.add_argument("--web-host", default=None, help="Override web bind host.")
+    parser.add_argument("--web-port", type=int, default=None, help="Override web port.")
+    args = parser.parse_args()
+
+    base = load_config()
+    cfg = Config(
+        db_path=base.db_path,
+        web_host=args.web_host or base.web_host,
+        web_port=args.web_port or base.web_port,
+        no_web=args.no_web or base.no_web,
+    )
+
+    configure_logging()
+
+    if not cfg.no_web:
+        _start_web_in_thread(cfg)
+
+    # Foreground: MCP server over stdio. Blocks until the client disconnects.
+    mcp_server.run(cfg)
+
+
+if __name__ == "__main__":
+    main()

progi/config.py

@@ -0,0 +1,63 @@
+"""Runtime configuration, resolved from environment variables with sane defaults.
+
+All configuration funnels through here so the MCP server, the web app, and the
+CLI agree on the same values (database location, web bind address, etc.).
+"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+try:
+    # platformdirs gives us OS-appropriate data locations
+    # (~/.local/share/progi on Linux, ~/Library/Application Support/progi on
+    # macOS, %LOCALAPPDATA%\progi on Windows).
+    from platformdirs import user_data_dir
+
+    _DEFAULT_DATA_DIR = Path(user_data_dir("progi", appauthor=False))
+except Exception:  # pragma: no cover - platformdirs is a hard dependency, but be safe
+    _DEFAULT_DATA_DIR = Path.home() / ".progi"
+
+
+def _env_bool(name: str, default: bool = False) -> bool:
+    raw = os.environ.get(name)
+    if raw is None:
+        return default
+    return raw.strip().lower() in {"1", "true", "yes", "on"}
+
+
+def _resolve_db_path() -> Path:
+    """Where the SQLite file lives. Override with PROGI_DB_PATH."""
+    override = os.environ.get("PROGI_DB_PATH")
+    if override:
+        return Path(override).expanduser().resolve()
+    return (_DEFAULT_DATA_DIR / "progi.db").resolve()
+
+
+@dataclass(frozen=True)
+class Config:
+    db_path: Path
+    web_host: str
+    web_port: int
+    # When True, the bundled run mode skips starting the web server.
+    no_web: bool
+
+    @property
+    def sqlalchemy_url(self) -> str:
+        # SQLite URL. The path is absolute so it does not depend on CWD.
+        return f"sqlite:///{self.db_path}"
+
+    def ensure_dirs(self) -> None:
+        self.db_path.parent.mkdir(parents=True, exist_ok=True)
+
+
+def load_config() -> Config:
+    cfg = Config(
+        db_path=_resolve_db_path(),
+        web_host=os.environ.get("PROGI_WEB_HOST", "127.0.0.1"),
+        web_port=int(os.environ.get("PROGI_WEB_PORT", "8000")),
+        no_web=_env_bool("PROGI_NO_WEB", default=False),
+    )
+    return cfg