Rename Castle -> Wild PC across the repo

Repo-side rename only (Phases 1-3 of the migration plan); the live box
(~/.castle, systemd units, /data/castle, domains) is a separate cutover.

- Slug `castle` -> `wildpc`: CLI command, module names (wildpc_core/cli/api),
  dist names, entry point `wildpc = wildpc_cli.main:main`.
- Identifiers: CastleConfig/NATSClient/DirError/MDNS -> Wildpc*.
- Env/constants: CASTLE_* -> WILDPC_*; ~/.castle -> ~/.wildpc, castle.yaml ->
  wildpc.yaml, /data/castle -> /data/wildpc.
- Systemd UNIT_PREFIX castle- -> wildpc-; own programs castle-api/gateway/etc.
- Display prose "Castle" -> "Wild PC" in docs, agent-guide files, README, frontend.
- Package dirs and bootstrap yaml renamed via git mv; lockfiles regenerated;
  redundant nested uv.lock files dropped (workspace root lock is authoritative).

Tests: core 273, cli 47, wildpc-api 120 all pass. Frontend type-checks + builds.
Fixed a stale test fixture (secret_env_path kind arg) broken pre-rename.
This commit is contained in:
2026-07-18 22:55:08 -07:00
parent 25d7a522cc
commit 05b28cb584
190 changed files with 2428 additions and 3337 deletions

View File

@@ -0,0 +1,72 @@
"""Apply (converge) API endpoint.
`POST /apply` reconciles the running system to match config — render units/
Caddyfile/tunnel, then activate/restart/deactivate to match. It replaces the old
`/deploy` (+ separate start/enable calls). `?plan=true` returns the diff without
touching anything.
"""
from __future__ import annotations
from fastapi import APIRouter, HTTPException
from pydantic import BaseModel
from wildpc_core.config import WildpcDirError
from wildpc_core.deploy import apply
router = APIRouter(tags=["apply"])
class ApplyRequest(BaseModel):
"""Optional request body for apply."""
name: str | None = None
plan: bool = False
class ApplyResponse(BaseModel):
"""The diff a converge enacted (or would enact, for a plan)."""
status: str
planned: bool
changed: bool
activated: list[str]
restarted: list[str]
deactivated: list[str]
unchanged: list[str]
messages: list[str]
@router.post("/apply", response_model=ApplyResponse)
def run_apply(request: ApplyRequest | None = None) -> ApplyResponse:
"""Converge the running system to match wildpc.yaml.
Renders systemd units + the Caddyfile + tunnel config, then reconciles the
runtime: activate enabled deployments that are down, restart any whose unit
changed, deactivate disabled ones. Pass a name to converge one deployment,
or `plan: true` to compute the diff without changing anything.
"""
name = request.name if request else None
plan = request.plan if request else False
try:
result = apply(target_name=name, plan=plan)
except FileNotFoundError as e:
raise HTTPException(status_code=404, detail=str(e)) from e
except WildpcDirError as e:
# A fixable misconfiguration (e.g. data_dir points somewhere unwritable), not a
# server fault — return the actionable message so the dashboard can show it.
raise HTTPException(status_code=422, detail=str(e)) from e
except Exception as e:
raise HTTPException(status_code=500, detail=str(e)) from e
return ApplyResponse(
status="ok",
planned=result.planned,
changed=result.changed,
activated=result.activated,
restarted=result.restarted,
deactivated=result.deactivated,
unchanged=result.unchanged,
messages=result.messages,
)