feat: add guided one-command installer
This commit is contained in:
@@ -0,0 +1,107 @@
|
||||
from __future__ import annotations
|
||||
|
||||
from .auth import connect_with_personal_key, normalize_api_base_url
|
||||
from .common import (
|
||||
DEFAULT_ENV_NAME,
|
||||
ENV_NAME_PATTERN,
|
||||
SERVER_NAME,
|
||||
Any,
|
||||
Callable,
|
||||
InstallerError,
|
||||
Path,
|
||||
Runner,
|
||||
Which,
|
||||
_project_root,
|
||||
shutil,
|
||||
subprocess,
|
||||
sys,
|
||||
)
|
||||
from .diagnostics import doctor_project
|
||||
from .project import inspect_project, prepare_project, render_client_config
|
||||
|
||||
|
||||
def install_project(
|
||||
project_root: str | Path | None,
|
||||
api_base_url: str,
|
||||
*,
|
||||
env_name: str = DEFAULT_ENV_NAME,
|
||||
enable_writes: bool = False,
|
||||
runner: Runner = subprocess.run,
|
||||
which: Which = shutil.which,
|
||||
python_version: tuple[int, int, int] | None = None,
|
||||
stdin_isatty: Callable[[], bool] = sys.stdin.isatty,
|
||||
) -> dict[str, Any]:
|
||||
"""Prepare, authenticate, diagnose, and describe one local installation.
|
||||
|
||||
The returned client configuration is intentionally not written here: the
|
||||
installation Agent must merge it into its own client-specific format after
|
||||
showing the destination and creating a recoverable backup.
|
||||
"""
|
||||
|
||||
root = _project_root(project_root)
|
||||
normalized_url = normalize_api_base_url(api_base_url)
|
||||
if not ENV_NAME_PATTERN.fullmatch(env_name):
|
||||
raise InstallerError(
|
||||
"Environment name must start with a letter or digit and contain only letters, digits, dot, underscore, or dash"
|
||||
)
|
||||
if not stdin_isatty():
|
||||
raise InstallerError(
|
||||
"Secure API Key entry requires a user-controlled local terminal. "
|
||||
"Do not paste the Key into Agent chat or pass it with --access-token."
|
||||
)
|
||||
|
||||
inspection = inspect_project(root, which=which, python_version=python_version)
|
||||
failed_prerequisites = [check["detail"] for check in inspection["checks"] if check["required"] and not check["ok"]]
|
||||
if failed_prerequisites:
|
||||
raise InstallerError("Installation prerequisites are not ready: " + "; ".join(failed_prerequisites))
|
||||
|
||||
prepared = prepare_project(
|
||||
root,
|
||||
runner=runner,
|
||||
which=which,
|
||||
python_version=python_version,
|
||||
)
|
||||
authentication = connect_with_personal_key(
|
||||
root,
|
||||
normalized_url,
|
||||
env_name=env_name,
|
||||
runner=runner,
|
||||
which=which,
|
||||
stdin_isatty=stdin_isatty,
|
||||
)
|
||||
diagnosis = doctor_project(
|
||||
root,
|
||||
runner=runner,
|
||||
which=which,
|
||||
python_version=python_version,
|
||||
)
|
||||
client_config = render_client_config(root, enable_writes=enable_writes, which=which)
|
||||
local_ready = bool(diagnosis["ok"])
|
||||
return {
|
||||
"ok": local_ready,
|
||||
"status": "ready-for-client-registration" if local_ready else "local-checks-failed",
|
||||
"projectRoot": str(root),
|
||||
"mode": "project-writes" if enable_writes else "read-only",
|
||||
"prepared": {
|
||||
"environmentPath": prepared["environmentPath"],
|
||||
"dependencyProfile": prepared["dependencies"],
|
||||
"configCreated": prepared["configCreated"],
|
||||
},
|
||||
"authentication": authentication,
|
||||
"checks": diagnosis["checks"],
|
||||
"clientConfig": client_config,
|
||||
"clientRegistration": {
|
||||
"required": True,
|
||||
"serverName": SERVER_NAME,
|
||||
"backupRequired": True,
|
||||
"action": "merge the generated server entry, reload the client, then call crm_health",
|
||||
},
|
||||
"remainingActions": [
|
||||
"Merge clientConfig into the current MCP client without replacing other servers.",
|
||||
"Reload or restart the MCP client.",
|
||||
"Call crm_health and require ok=true before reporting installation complete.",
|
||||
],
|
||||
}
|
||||
|
||||
|
||||
__all__ = ["install_project"]
|
||||
Reference in New Issue
Block a user