ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
Remove internal plan citations from app code
Juan Denis6296887bad25
diff --git a/backend/app/__init__.py b/backend/app/__init__.pyindex 843b473a..793cd341 100644--- a/backend/app/__init__.py+++ b/backend/app/__init__.py@@ -260,7 +260,7 @@ def create_app(config_name=None):SettingsService.initialize_defaults()SettingsService.migrate_legacy_roles()if not app.config.get('TESTING'):- # Size-aware retention defaults, once per install (plan 85 §C).+ # Size-aware retention defaults, once per install.# Skipped under test: the result would depend on the test host's disk.try:from app.services import storage_profile_service@@ -276,7 +276,7 @@ def create_app(config_name=None):n_dns = DNSProviderService.encrypt_legacy_secrets()n_store = StorageProviderService.encrypt_legacy_secrets()# Cloud-provider legacy-secret encryption moved out with the- # serverkit-cloud-provision extension (plan 47). It was a one-time+ # serverkit-cloud-provision extension. It was a one-time# migration of pre-encryption rows; any panel reaching this version# already ran it in an earlier boot (idempotent), and the extension# encrypts on write, so there's nothing left for core to do here.@@ -306,7 +306,7 @@ def create_app(config_name=None):import logging as _logging_logging.getLogger(__name__).warning(f'Legacy secret encryption skipped: {e}')- # Record this boot's hardware and compare it to the last one (plan 74).+ # Record this boot's hardware and compare it to the last one.# Boot is the right hook: a VPS resize requires a power-off, so the# change and the restart are the same event — and the in-memory spec# cache that used to be the only "before" value dies with the process.@@ -370,7 +370,7 @@ def create_app(config_name=None):import logginglogging.getLogger(__name__).warning(f'Extension auto-install: {e}')- # Upgrade parity for the extracted security suite (plan 47 Ph3b-4):+ # Upgrade parity for the extracted security suite:# a panel that was actually using fail2ban/clamav/lynis/auto-updates/# image scanning gets the matching registry extension once its entry# is published. Fail-soft, retries per boot until then. Best-effort.@@ -382,7 +382,7 @@ def create_app(config_name=None):logging.getLogger(__name__).warning(f'Security-suite auto-install: {e}')# One-shot: re-acquire the now-extracted backend for converted builtins- # that first shipped frontend-only (plan 47 Phase 2), so an upgraded panel+ # that first shipped frontend-only, so an upgraded panel# that installed them frontend-only doesn't lose the API. Best-effort.try:from app.services.extension_migration import run_backend_acquisition@@ -450,7 +450,7 @@ def create_app(config_name=None):DeploymentJobService.register_jobs()from app.services.recipe_execution_service import RecipeExecutionServiceRecipeExecutionService.register_jobs()- # WorkflowEngine.register_jobs() removed in plan 45 Phase 4 (engine retired).+ # WorkflowEngine.register_jobs() removed (engine retired).from app.services.backup_service import BackupServiceBackupService.register_jobs()from app.services.backup_policy_service import BackupPolicyService@@ -463,7 +463,7 @@ def create_app(config_name=None):MetadataGuardService.register_jobs()if not app.config.get('TESTING'):MetadataGuardService.ensure() # converge the metadata egress rule (no-op when unsupported)- # Bound the log files the panel writes or causes (plan 85 A5).+ # Bound the log files the panel writes or causes.from app.services import log_limits_servicelog_limits_service.converge()from app.services.speed_test_service import SpeedTestServicediff --git a/backend/app/agent_gateway.py b/backend/app/agent_gateway.pyindex f31e55ab..cefc2de4 100644--- a/backend/app/agent_gateway.py+++ b/backend/app/agent_gateway.py@@ -20,7 +20,7 @@ from app.models.server import Serverlogger = logging.getLogger(__name__)# The per-IP auth rate limiter is transport-neutral state and lives with the-# shared handshake door in agent_registry (plan 77 A2). Re-exported here for+# shared handshake door in agent_registry. Re-exported here for# callers/tests that historically reached it via the gateway module.from app.services.agent_registry import ( # noqa: F401_AUTH_RATE_LIMIT,@@ -53,8 +53,8 @@ class AgentNamespace(Namespace):"""Handle agent authentication.- Thin adapter over agent_registry.authenticate_and_register (plan 77- A2) — the handshake sequence itself is transport-neutral and shared+ Thin adapter over agent_registry.authenticate_and_register — the+ handshake sequence itself is transport-neutral and sharedwith the long-poll /connect endpoint; this handler only translatesthe outcome into socket emits/disconnects.diff --git a/backend/app/api/agent_poll.py b/backend/app/api/agent_poll.pyindex d0cb82de..218cb373 100644--- a/backend/app/api/agent_poll.py+++ b/backend/app/api/agent_poll.py@@ -28,7 +28,7 @@ agent_poll_bp = Blueprint('agent_poll', __name__)def _client_ip():- # ProxyFix-corrected real client IP when TRUST_PROXY_HEADERS is on (plan 48),+ # ProxyFix-corrected real client IP when TRUST_PROXY_HEADERS is on,# so the shared per-IP auth throttle keys on the real agent, not nginx.return request.remote_addr or 'unknown'@@ -38,7 +38,7 @@ def connect():"""Authenticate an agent and return a session_token bound to apolling-mode ConnectedAgent.- Thin adapter over agent_registry.authenticate_and_register (plan 77 A2)+ Thin adapter over agent_registry.authenticate_and_register— the exact sequence the WS on_auth handler runs, minus the socket-roombookkeeping; this endpoint only translates the outcome to HTTP."""data = request.get_json(silent=True) or {}@@ -104,7 +104,7 @@ def poll():list(caps.keys()) if isinstance(caps, dict) else None,)- # Shared transport-neutral ingest (plan 77 A1/A2): capability+ # Shared transport-neutral ingest: capability# side-effects (e.g. tunnel reconcile) fire exactly as on the WS path.agent_registry.ingest_agent_state(agent, metrics=metrics, sysinfo=sysinfo,capabilities=caps)diff --git a/backend/app/api/app_attachments.py b/backend/app/api/app_attachments.pyindex 74eed5ba..78a7e6fe 100644--- a/backend/app/api/app_attachments.py+++ b/backend/app/api/app_attachments.py@@ -1,6 +1,6 @@-# Bucket: PER-APP (plan 29 #9). Reads gate on can_access_app; attach/detach+# Bucket: PER-APP. Reads gate on can_access_app; attach/detach# gate on can_edit_app for the app AND can_access_app for the service used.-"""Attach services an app uses (plan 86 §C2/§C4). Mounted under ``/api/v1/apps``.+"""Attach services an app uses. Mounted under ``/api/v1/apps``.GET /<app_id>/attachments — this app's attachmentsGET /attachments/services?kind=<kind> — installed services for a kind@@ -90,7 +90,7 @@ def detach(app_id, attachment_id):return jsonify(body)-# ==================== CONNECTION POOLING (plan 86 §D1) ====================+# ==================== CONNECTION POOLING ====================@app_attachments_bp.route('/<int:app_id>/pooler', methods=['GET'])@viewer_required@@ -121,7 +121,7 @@ def set_pooler(app_id):return jsonify(result)-# ==================== BOTTLENECK HINTS (plan 86 §A5) ====================+# ==================== BOTTLENECK HINTS ====================@app_attachments_bp.route('/<int:app_id>/hints', methods=['GET'])@viewer_required@@ -133,7 +133,7 @@ def get_hints(app_id):return jsonify({'hints': BottleneckHintsService.hints(app)})-# ==================== IMMUTABLE ASSETS (plan 86 §B2) ====================+# ==================== IMMUTABLE ASSETS ====================@app_attachments_bp.route('/<int:app_id>/immutable-assets', methods=['PUT'])@developer_requireddiff --git a/backend/app/api/app_slots.py b/backend/app/api/app_slots.pyindex b750eae8..6de823e3 100644--- a/backend/app/api/app_slots.py+++ b/backend/app/api/app_slots.py@@ -1,6 +1,6 @@-# Bucket: PER-APP (plan 29 #9). Reads gate on can_access_app; changes gate on+# Bucket: PER-APP. Reads gate on can_access_app; changes gate on# can_edit_app.-"""A/B slot deploys (plan 87). Mounted under ``/api/v1/apps``.+"""A/B slot deploys. Mounted under ``/api/v1/apps``.GET /<app_id>/slots — slots, active slot, eligibility + reasonsPUT /<app_id>/slots — {enabled}: opt in (adopts the currentdiff --git a/backend/app/api/app_volumes.py b/backend/app/api/app_volumes.pyindex a137cc6d..ebe1f7b0 100644--- a/backend/app/api/app_volumes.py+++ b/backend/app/api/app_volumes.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Volume routes gate on the shared app-access seam+# Bucket: PER-APP. Volume routes gate on the shared app-access seam# (can_access_app for reads, can_edit_app for attach/detach mutations)."""Per-app managed volume API — attach/list/detach first-class persistentvolumes for an application. Mounted under ``/api/v1/apps`` alongside the maindiff --git a/backend/app/api/apps.py b/backend/app/api/apps.pyindex be84c816..10cc4e63 100644--- a/backend/app/api/apps.py+++ b/backend/app/api/apps.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Per-app routes gate on the shared app-access+# Bucket: PER-APP. Per-app routes gate on the shared app-access# seam via the file-local _can_access_app (reads) / _can_edit_app (writes)# helpers, or the hand-rolled owner-or-admin idiom; host/system ops stay admin.import os@@ -1775,7 +1775,7 @@ def set_micro_cache(app_id):@apps_bp.route('/<int:app_id>/micro-cache/purge', methods=['POST'])@jwt_required()def purge_micro_cache(app_id):- """Clear this site's cached pages (plan 86 §B3).+ """Clear this site's cached pages.The zone is shared, but the cache key carries the host, so only entriesfor this app's domains are removed. No nginx reload is needed.@@ -2373,7 +2373,7 @@ def create_app_db_snapshot(app_id):return jsonify({'error': 'This service is not a WordPress site'}), 400# Resolve the extension only once we know this IS a WordPress site — with# serverkit-wordpress uninstalled a non-WP app must get the 400, not an- # import error (plan 52 Phase 5 graceful absence). A WP SITE with the+ # import error (graceful absence). A WP SITE with the# extension missing/disabled gets a clean 503, not an uncaught# WordPressExtensionMissingError → 500 (audit F3).from app.services.wordpress_bridge import (diff --git a/backend/app/api/auth.py b/backend/app/api/auth.pyindex 37682986..972a631a 100644--- a/backend/app/api/auth.py+++ b/backend/app/api/auth.py@@ -208,7 +208,7 @@ def complete_onboarding():# Slugs the wizard installed (recorded for Setup Health / support). The# actual installs happen client-side via the plugin install endpoints; this- # just persists what onboarding did (plan 47).+ # just persists what onboarding did.installed_extensions = data.get('installed_extensions', [])if not isinstance(installed_extensions, list):return jsonify({'error': 'installed_extensions must be a list'}), 400@@ -216,7 +216,7 @@ def complete_onboarding():s for s in installed_extensions if isinstance(s, str) and s.strip()]- # Security posture (plan 47 Ph5) — persisted separately from use_cases so+ # Security posture — persisted separately from use_cases so# posture and purpose stay orthogonal. Absent/invalid falls back to the# lean default rather than failing the whole onboarding.security_posture = data.get('security_posture', 'minimal')@@ -232,7 +232,7 @@ def complete_onboarding():user_id=user.id)# Keep the panel lean: suppress wizard-optional flagships (WordPress) the- # user didn't install so the boot seeder won't re-add them (plan 47).+ # user didn't install so the boot seeder won't re-add them.try:from app.services import plugin_serviceplugin_service.finalize_setup_flagships()diff --git a/backend/app/api/backups.py b/backend/app/api/backups.pyindex 319b7247..f90bd341 100644--- a/backend/app/api/backups.py+++ b/backend/app/api/backups.py@@ -12,7 +12,7 @@ from app.exceptions import field_required, not_foundbackups_bp = Blueprint('backups', __name__)-# UI-facing metadata for the CORE target types (plan 52 D4). Extension kinds+# UI-facing metadata for the CORE target types. Extension kinds# carry their own label/scopes in backup_kind_registry. 'server' is listed# but flagged unimplemented so the UI never shows a dead whole-server button._CORE_TARGET_META = {diff --git a/backend/app/api/bandwidth.py b/backend/app/api/bandwidth.pyindex 05e35a63..b93cd5ef 100644--- a/backend/app/api/bandwidth.py+++ b/backend/app/api/bandwidth.py@@ -1,4 +1,4 @@-# Bucket: PER-APP read (plan 29 #9). Per-app bandwidth is scoped to callers who+# Bucket: PER-APP read. Per-app bandwidth is scoped to callers who# can access the app (can_access_app); the cross-app overview stays panel-wide."""REST surface for per-domain bandwidth accounting.@@ -35,7 +35,7 @@ def get_apps_bandwidth():@viewer_requireddef get_app_bandwidth(app_id):"""Full daily series (default 90 days) + current-month total for one app,- scoped to the app's workspace visibility (plan 29 #9 — foreign caller 404)."""+ scoped to the app's workspace visibility (foreign caller 404)."""app = Application.query_active().filter_by(id=app_id).first()user = get_current_user()if app is None or not ResourceGrantService.can_access_app(user, app):@@ -57,8 +57,8 @@ def get_app_bandwidth(app_id):@viewer_requireddef get_app_request_metrics(app_id):"""Request rate, status classes, latency percentiles and cache hit ratio- from the timed access log (plan 86 §A2). ``period``: 1h, 24h, 7d or 30d."""- # Same 404 for a missing and a foreign app (plan 29 #9); a bad period is a+ from the timed access log. ``period``: 1h, 24h, 7d or 30d."""+ # Same 404 for a missing and a foreign app; a bad period is a# ValidationError (400). Both go through the global handler.app = RequestMetricsService.live_app(app_id)if app is None or not ResourceGrantService.can_access_app(get_current_user(), app):diff --git a/backend/app/api/builds.py b/backend/app/api/builds.pyindex 60c970dd..0bb41bbc 100644--- a/backend/app/api/builds.py+++ b/backend/app/api/builds.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Per-app build routes gate via the app-grant+# Bucket: PER-APP. Per-app build routes gate via the app-grant# family (can_access_app / can_edit_app). See docs/WORKSPACE_SCOPING.md."""Build and Deployment API Endpoints@@ -201,7 +201,7 @@ def clear_build_cache(app_id):def deploy_app(app_id):"""Deploy an application (build + deploy).- Every deploy is a job (plan 51 D7): by default this enqueues an `app_deploy`+ Every deploy is a job: by default this enqueues an `app_deploy`DeploymentJob and returns 202 + {deploy_job_id} so the UI can open the liveDeploy Console. `?wait=true` preserves the old synchronous contract forCLI/tests (runs inline, returns the deployment result body).diff --git a/backend/app/api/connect.py b/backend/app/api/connect.pyindex 5e810adc..196fa357 100644--- a/backend/app/api/connect.py+++ b/backend/app/api/connect.py@@ -22,7 +22,7 @@ def get_status():@connect_bp.route('/managed-profile', methods=['GET'])@admin_requireddef get_managed_profile():- """The managed profile in force (plan 25). Read-only: the signed+ """The managed profile in force. Read-only: the signedui.managed_profile command handler is the only writer, and lifting theprofile from ServerKit Cloud — never from here — is the only off switchother than expiry or revocation."""diff --git a/backend/app/api/container_status.py b/backend/app/api/container_status.pyindex b30684c0..d53c9317 100644--- a/backend/app/api/container_status.py+++ b/backend/app/api/container_status.py@@ -1,4 +1,4 @@-# Bucket: PER-APP read (plan 29 #9). The single-app status read gates on app+# Bucket: PER-APP read. The single-app status read gates on app# visibility via require_app_member (viewer+); the all-apps roll-up is a# panel-wide authed read."""REST surface for the centralized container status aggregator.diff --git a/backend/app/api/cron.py b/backend/app/api/cron.pyindex f739a00b..358fadb9 100644--- a/backend/app/api/cron.py+++ b/backend/app/api/cron.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Per-app cron routes gate via the app-grant+# Bucket: PER-APP. Per-app cron routes gate via the app-grant# family (can_access_app / can_edit_app). See docs/WORKSPACE_SCOPING.md."""Cron Job Management API@@ -263,7 +263,7 @@ def ingest_run():"""# The cron-run shim posts DIRECTLY to the panel's loopback gunicorn port# (cli_api_client base http://127.0.0.1:<port>), never through nginx, so no- # X-Forwarded-For is present and ProxyFix (plan 48) leaves remote_addr as the+ # X-Forwarded-For is present and ProxyFix leaves remote_addr as the# real 127.0.0.1 peer. A request routed through nginx instead carries the# real client as the rightmost hop, so this gate can't be spoofed to 127.0.0.1.remote = (request.remote_addr or '')diff --git a/backend/app/api/dashboards.py b/backend/app/api/dashboards.pyindex 623b12f3..6e57b647 100644--- a/backend/app/api/dashboards.py+++ b/backend/app/api/dashboards.py@@ -1,4 +1,4 @@-"""Dashboard boards API (plan 62) — /api/v1/dashboards.+"""Dashboard boards API — /api/v1/dashboards.Per-user dashboard tabs and their widget layout. Everything here is scoped tothe calling user: a board that belongs to somebody else is indistinguishablediff --git a/backend/app/api/database_engines.py b/backend/app/api/database_engines.pyindex 52960bd4..1fc62649 100644--- a/backend/app/api/database_engines.py+++ b/backend/app/api/database_engines.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). The per-app extension routes+# Bucket: PER-APP. The per-app extension routes# (/<app_id>/extensions) address one installed engine, so they gate on# can_access_app; the catalog reads above them are system-level and carry no# app linkage, and every mutation is admin-only.diff --git a/backend/app/api/databases.py b/backend/app/api/databases.pyindex 7b11295e..18a1fe42 100644--- a/backend/app/api/databases.py+++ b/backend/app/api/databases.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). The per-app docker DB read (/docker/app/<app_id>)+# Bucket: PER-APP. The per-app docker DB read (/docker/app/<app_id>)# gates on can_access_app; the bare-container docker routes have no app linkage# and are system-level admin-only, matching their kill/drop siblings.# The host-level raw routes (engine lists, tables/structure, users/privileges,@@ -963,7 +963,7 @@ def kill_docker_db_process(container, pid):return jsonify(result), 200-# ==================== INSIGHTS (plan 86 §A3) ====================+# ==================== INSIGHTS ====================# Read-only top queries + connection / cache-hit gauges for a Docker database# container, and the one write it offers: turning pg_stat_statements on# (through the config tuner, so its rollback undoes it).diff --git a/backend/app/api/deploy.py b/backend/app/api/deploy.pyindex 93ad6a47..dcf3fc58 100644--- a/backend/app/api/deploy.py+++ b/backend/app/api/deploy.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Deploy config reads/writes gate on the shared+# Bucket: PER-APP. Deploy config reads/writes gate on the shared# app-access seam (can_access_app / can_edit_app); the public inbound webhook is# token/signature-verified (ALLOWLISTed — no per-app user session).import osdiff --git a/backend/app/api/deployment_jobs.py b/backend/app/api/deployment_jobs.pyindex b285c3ac..4358af12 100644--- a/backend/app/api/deployment_jobs.py+++ b/backend/app/api/deployment_jobs.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). App-linked job reads gate on the app-grant+# Bucket: PER-APP. App-linked job reads gate on the app-grant# seam (can_access_app); retries require can_operate_app. App-less jobs# (template installs, simulated deploys) are requester-or-admin only. The# job list is admin-only globally and app-access-gated when app_id is given.@@ -51,7 +51,7 @@ def _job_payload(job, user, include_plan=False, include_logs=False):@deployment_jobs_bp.route('/simulate', methods=['GET'])@jwt_required()def get_simulate_info():- """Simulated-deploy availability + scenario catalog (plan 51.5 dev tool).+ """Simulated-deploy availability + scenario catalog (dev tool).404 when the DEMO_DEPLOYS_ENABLED gate is off (production default), so thesurface simply doesn't exist outside dev.@@ -152,8 +152,8 @@ def get_deployment_job(job_id):@deployment_jobs_bp.route('/<job_id>/retry', methods=['POST'])@jwt_required()def retry_deployment_job(job_id):- """Retry a failed deployment job by cloning it and enqueuing a fresh run- (plan 51 D8). Only failed jobs may be retried."""+ """Retry a failed deployment job by cloning it and enqueuing a fresh run.+Only failed jobs may be retried."""job = DeploymentJob.query.get(job_id)if not job:raise not_found('deployment')diff --git a/backend/app/api/deployments.py b/backend/app/api/deployments.pyindex 7d37ead1..e943fcdc 100644--- a/backend/app/api/deployments.py+++ b/backend/app/api/deployments.py@@ -1,4 +1,4 @@-# Bucket: PER-APP read (plan 29 #9). Per-app history gates via _access →+# Bucket: PER-APP read. Per-app history gates via _access →# can_access_app. See docs/WORKSPACE_SCOPING.md."""Unified deployment surface (§3 unification).diff --git a/backend/app/api/dns_cutover.py b/backend/app/api/dns_cutover.pyindex 17bf7fd1..5a8baf68 100644--- a/backend/app/api/dns_cutover.py+++ b/backend/app/api/dns_cutover.py@@ -6,7 +6,7 @@ public resolvers, and revert — restoring the pre-cutover world byte-for-byte.Read verbs (ttl-guidance, list/get snapshots, verify) are open to anyauthenticated user; the mutating verbs (snapshot, cutover, revert) are-admin-only (plan 31 #1/#2/#3).+admin-only."""from flask import Blueprint, request, jsonifyfrom flask_jwt_extended import jwt_requireddiff --git a/backend/app/api/domains.py b/backend/app/api/domains.pyindex d54391a9..8abf2d0c 100644--- a/backend/app/api/domains.py+++ b/backend/app/api/domains.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Per-app domain routes gate on the shared+# Bucket: PER-APP. Per-app domain routes gate on the shared# app-access seam (can_access_app for reads, can_edit_app for mutations);# host-level DNS/nginx surfaces stay admin-only.import rediff --git a/backend/app/api/env_vars.py b/backend/app/api/env_vars.pyindex 2af9ced2..a0c47d23 100644--- a/backend/app/api/env_vars.py+++ b/backend/app/api/env_vars.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Env-var routes converge on the app-access seam:+# Bucket: PER-APP. Env-var routes converge on the app-access seam:# reads use can_access_app (owner/admin/any grant — a viewer grant can read,# with secrets still masked), writes use can_edit_app (owner/admin/editor grant)."""@@ -19,7 +19,7 @@ env_vars_bp = Blueprint('env_vars', __name__)def check_app_access(app_id, user_id, write=False):- """Check that the user may access the application's env vars (plan 29 #9).+ """Check that the user may access the application's env vars.Reads (``write=False``) require can_access_app (owner/admin/any grant);writes require can_edit_app (owner/admin/editor grant — a viewer grant isdiff --git a/backend/app/api/fleet_doctor.py b/backend/app/api/fleet_doctor.pyindex 020de49e..a237aa6e 100644--- a/backend/app/api/fleet_doctor.py+++ b/backend/app/api/fleet_doctor.py@@ -1,5 +1,5 @@"""REST surface for the fleet health doctor — the panel-host doctor extended-across the agent fleet (plan 26 / ``docs/FLEET_CONTRACT.md``).+across the agent fleet (``docs/FLEET_CONTRACT.md``).Mounted at /api/v1/doctor/fleet (registered in app/__init__.py). Admin-only:the fleet is not workspace-scoped (Fleet Contract, "explicitly out of scope").diff --git a/backend/app/api/fleet_monitor.py b/backend/app/api/fleet_monitor.pyindex 91411b57..d112ce9b 100644--- a/backend/app/api/fleet_monitor.py+++ b/backend/app/api/fleet_monitor.py@@ -190,7 +190,7 @@ def prometheus_metrics():"""Prometheus-compatible metrics endpoint (no JWT, uses token param).Accepts ``PROMETHEUS_TOKEN`` from the environment or the panel's own scrape- token, the one the Prometheus template is installed with (plan 86 §A4).+ token, the one the Prometheus template is installed with."""from app.services import metrics_token_servicetoken = request.args.get('token') or request.headers.get('X-Prometheus-Token')diff --git a/backend/app/api/git.py b/backend/app/api/git.pyindex 52f8daad..225f255d 100644--- a/backend/app/api/git.py+++ b/backend/app/api/git.py@@ -1,11 +1,11 @@-# Bucket: PER-APP (plan 29 #9, #11). The per-app deployment read gates on app+# Bucket: PER-APP. The per-app deployment read gates on app# visibility (require_app_member); webhook reads are scoped to the linked app's# visibility (an unlinked webhook stays panel-wide viewer-visible). Webhook# mutations and the Gitea host lifecycle stay admin-only."""Git webhook + deployment API — the deploy-pipeline half.The Gitea self-host surface (lifecycle + repo browsing) moved to the-serverkit-git extension (plan 52 Phase 6), which mounts it back at this same+serverkit-git extension, which mounts it back at this same/api/v1/git prefix when installed."""from flask import Blueprint, request, jsonify@@ -25,7 +25,7 @@ git_bp = Blueprint('git', __name__)def _webhook_visible_to(user, webhook):"""A webhook with no app linkage is a panel-wide viewer-visible resource; anapp-linked webhook is visible only to callers who can reach that app- (owner/admin/grant/workspace member — plan 29 #11)."""+ (owner/admin/grant/workspace member)."""if not getattr(webhook, 'app_id', None):return True# Deliberately unfiltered: this gate falls through to "panel-wide visible"@@ -44,7 +44,7 @@ def _webhook_visible_to(user, webhook):@git_bp.route('/webhooks', methods=['GET'])@viewer_requireddef list_webhooks():- """List webhooks the caller can see (plan 29 #11): every unlinked webhook+ """List webhooks the caller can see: every unlinked webhookplus any app-linked webhook whose app they can reach."""user = get_current_user()result = WebhookService.list_webhooks()diff --git a/backend/app/api/image_updates.py b/backend/app/api/image_updates.pyindex a0c86a1c..24359c3e 100644--- a/backend/app/api/image_updates.py+++ b/backend/app/api/image_updates.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). The registry-check trigger stays admin; the+# Bucket: PER-APP. The registry-check trigger stays admin; the# latest-check read is scoped to callers who can access the app (can_access_app).from flask import Blueprint, jsonifyfrom flask_jwt_extended import jwt_required@@ -29,7 +29,7 @@ def check(app_id):def latest(app_id):"""Return the most recent image-update check for the application (or null).- Scoped to the app's workspace visibility (plan 29 #9) — a foreign caller+ Scoped to the app's workspace visibility — a foreign callergets a sealed 404."""app = Application.query_active().filter_by(id=app_id).first()user = get_current_user()diff --git a/backend/app/api/manifests.py b/backend/app/api/manifests.pyindex e16b983b..81c798af 100644--- a/backend/app/api/manifests.py+++ b/backend/app/api/manifests.py@@ -145,7 +145,7 @@ def apply_manifest():result = ManifestApplyService.apply(project, normalized, user_id=user.id,manifest_row=row)- # Appliance-tier blockers (plan 35): apply refused, nothing executed.+ # Appliance-tier blockers: apply refused, nothing executed.if result.get('refused'):return jsonify(result), 400diff --git a/backend/app/api/pairing.py b/backend/app/api/pairing.pyindex ae3357a3..1239ae54 100644--- a/backend/app/api/pairing.py+++ b/backend/app/api/pairing.py@@ -184,7 +184,7 @@ def claim():name=name,group_id=group_id,# Recorded for the pairing audit trail — the real operator IP once- # TRUST_PROXY_HEADERS is on (ProxyFix-corrected), not nginx's (plan 48).+ # TRUST_PROXY_HEADERS is on (ProxyFix-corrected), not nginx's.ip_address=request.remote_addr,)except PairingError as exc:diff --git a/backend/app/api/plugins.py b/backend/app/api/plugins.pyindex 66d74e47..8dd758a6 100644--- a/backend/app/api/plugins.py+++ b/backend/app/api/plugins.py@@ -65,7 +65,7 @@ def install_plugin():# Optional checksum continuity: the preview step returns the resolved URL +# sha256; passing them here pins the install to the exact previewed bytes.expected_sha256 = (data.get('sha256') or None)- # Optional signature continuity (plan 55): when the preview verified a+ # Optional signature continuity: when the preview verified a# detached signature, pass it through so the install re-verifies the exact# pinned bytes. A bad signature is a hard failure; no signature = the# consent card's "unsigned" path.@@ -337,7 +337,7 @@ def recommendations():use_cases = [u.strip() for u in raw.split(',') if u.strip()]return jsonify({'recommendations': recommend_extensions_for_use_cases(use_cases),- # Wizard round 2 (plan 47 Ph5): the security-posture chooser. Each+ # Wizard round 2: the security-posture chooser. Each# level lists only extensions the catalog can actually install today —# unpublished slugs drop out rather than rendering dead checkboxes.'security_postures': {@@ -518,7 +518,7 @@ def get_manifest_spec():@plugins_bp.route('/<int:plugin_id>/permissions', methods=['GET'])@jwt_required()def get_plugin_permissions(plugin_id):- """Declared vs actually-observed permission use for one extension (plan 55).+ """Declared vs actually-observed permission use for one extension.Admin-only: it describes what a piece of third-party code has been reachingfor, which is operator information.diff --git a/backend/app/api/previews.py b/backend/app/api/previews.pyindex 60fb6824..424955f4 100644--- a/backend/app/api/previews.py+++ b/backend/app/api/previews.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Reads require app access (can_access_app); the+# Bucket: PER-APP. Reads require app access (can_access_app); the# enable/sync/redeploy/destroy mutations require write access (can_edit_app),# replacing the old panel-wide @developer_required."""PR Preview Environments API.@@ -21,7 +21,7 @@ previews_bp = Blueprint('previews', __name__)def _get_app_or_404(app_id, write=False):- """Resolve the app and enforce per-app access (plan 29 #9). ``write`` requires+ """Resolve the app and enforce per-app access. ``write`` requirescan_edit_app (owner/admin/editor); otherwise can_access_app (adds workspacemembers). A caller without the needed tier gets a sealed 404 (no leak)."""app = Application.query_active().filter_by(id=app_id).first()diff --git a/backend/app/api/private_urls.py b/backend/app/api/private_urls.pyindex 7d3df785..bb5e8374 100644--- a/backend/app/api/private_urls.py+++ b/backend/app/api/private_urls.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Private-URL routes gate on the shared app-access+# Bucket: PER-APP. Private-URL routes gate on the shared app-access# seam (can_access_app for reads, can_edit_app for mutations)."""API endpoints for managing private URLs for applications."""diff --git a/backend/app/api/python.py b/backend/app/api/python.pyindex 064bb9d4..2cf3c69b 100644--- a/backend/app/api/python.py+++ b/backend/app/api/python.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Per-app Python runtime routes gate on the shared+# Bucket: PER-APP. Per-app Python runtime routes gate on the shared# app-access seam (can_access_app for reads, can_edit_app for mutations);# host-level interpreter management stays admin-only.from flask import Blueprint, request, jsonifydiff --git a/backend/app/api/recipes.py b/backend/app/api/recipes.pyindex 69ce76c7..c0c1006e 100644--- a/backend/app/api/recipes.py+++ b/backend/app/api/recipes.py@@ -1,4 +1,4 @@-"""Recipe run API (plan 68).+"""Recipe run API.Starts runs from three manifest sources — a registry slug (the curated``serverkit-recipes`` catalog), reviewed inline YAML/JSON, or a manifestdiff --git a/backend/app/api/restore_points.py b/backend/app/api/restore_points.pyindex bb1f1fbe..d520027f 100644--- a/backend/app/api/restore_points.py+++ b/backend/app/api/restore_points.py@@ -1,4 +1,4 @@-"""Generic restore-point lifecycle API (Plan 81, M3).+"""Generic restore-point lifecycle API.Application-owned scopes use the existing ResourceGrant seam. Host-levelsurfaces are operational and require a developer role even when their localdiff --git a/backend/app/api/runs.py b/backend/app/api/runs.pyindex e53a9508..da3de7a9 100644--- a/backend/app/api/runs.py+++ b/backend/app/api/runs.py@@ -1,4 +1,4 @@-"""Run envelope REST twin (plan 77 E1).+"""Run envelope REST twin.The polling counterpart of the `run_log` / `run_status` socket events: anyrun kind's persisted lines, resumable via ?after_id, so a client that misseddiff --git a/backend/app/api/search.py b/backend/app/api/search.pyindex a05ae82c..39ca5552 100644--- a/backend/app/api/search.py+++ b/backend/app/api/search.py@@ -1,4 +1,4 @@-"""Unified entity omnisearch API (plan 41, Phase 4).+"""Unified entity omnisearch API.A single authz-aware endpoint the command palette calls to search across thecore entity types (services, servers, domains, databases, WordPress sites, crondiff --git a/backend/app/api/security.py b/backend/app/api/security.pyindex 65080a9c..2d83446d 100644--- a/backend/app/api/security.py+++ b/backend/app/api/security.py@@ -1,7 +1,7 @@-# Bucket: PER-APP (plan 29 #9). Per-app scan/security routes gate on the shared+# Bucket: PER-APP. Per-app scan/security routes gate on the shared# app-access seam; host-level surfaces stay admin-only.#-# Lean core (plan 47 Ph3b-4 / plan 55 Phase 3): this blueprint keeps only the+# Lean core: this blueprint keeps only the# baseline that works with zero host packages — status/config, legacy# integrity, suspicious activity, events, SSH keys, IP lists, the audit and# scoped FIM. The install-gated tool surfaces (/clamav/*, /scan/*,diff --git a/backend/app/api/servers.py b/backend/app/api/servers.pyindex 32713033..9522ee3c 100644--- a/backend/app/api/servers.py+++ b/backend/app/api/servers.py@@ -131,7 +131,7 @@ PERMISSION_PROFILES = {'docker:volume:read','docker:network:read','system:metrics:read',- # Fleet doctor / survey reads (plan 28 #7): let the panel probe+ # Fleet doctor / survey reads: let the panel probe# host health without granting any mutating verb.'doctor:read','systemd:read',diff --git a/backend/app/api/site_imports.py b/backend/app/api/site_imports.pyindex 8e130d90..e9789b84 100644--- a/backend/app/api/site_imports.py+++ b/backend/app/api/site_imports.py@@ -33,7 +33,7 @@ def upload_archive():@admin_requireddef probe_ssh_source():"""Preflight an SSH import source: test the connection, list the docroot,- sniff the stack (plan 31 #8). Linux-only runtime — returns 501 on a host+ sniff the stack. Linux-only runtime — returns 501 on a hostthat can't run ssh (e.g. Windows dev) so the wizard can message it."""data = request.get_json(silent=True) or {}source = data.get('source') or datadiff --git a/backend/app/api/snapshots.py b/backend/app/api/snapshots.pyindex 4d7708a4..c53f2bfc 100644--- a/backend/app/api/snapshots.py+++ b/backend/app/api/snapshots.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Snapshot reads (list/get/diff) require app+# Bucket: PER-APP. Snapshot reads (list/get/diff) require app# access (can_access_app); restore requires write access (can_edit_app) on top# of the panel-wide @developer_required."""@@ -24,7 +24,7 @@ snapshots_bp = Blueprint('snapshots', __name__)def _get_app_or_404(app_id, write=False):- """Resolve the app and enforce per-app access (plan 29 #9). ``write`` requires+ """Resolve the app and enforce per-app access. ``write`` requirescan_edit_app (owner/admin/editor); otherwise can_access_app. A caller withoutthe needed tier gets a 403 (the resource itself exists)."""app = Application.query_active().filter_by(id=app_id).first()diff --git a/backend/app/api/survey.py b/backend/app/api/survey.pyindex 50269046..0c4433d4 100644--- a/backend/app/api/survey.py+++ b/backend/app/api/survey.py@@ -1,4 +1,4 @@-"""Server survey API — read-only "flights" over a paired agent (plan 27).+"""Server survey API — read-only "flights" over a paired agent.Mounted at /api/v1/servers (see app/__init__.py). All routes are admin-only: asurvey enumerates what's running on a host, and the catalog index is the honest@@ -42,7 +42,7 @@ def run_survey(server_id):@survey_bp.route('/<server_id>/management-mode', methods=['POST'])@admin_requireddef set_management_mode(server_id):- """Switch a server between 'managed' and 'observed' (plan 27, Decision 1/4).+ """Switch a server between 'managed' and 'observed' (Decision 1/4).An operator confirms mode changes; detection only ever SUGGESTS. Existingmanaged boxes are never auto-downgraded — this is the explicit, audited flip.@@ -62,7 +62,7 @@ def set_management_mode(server_id):previous = server.management_mode or 'managed'server.management_mode = mode- # Optional break-glass toggle (plan 31 #10, Decision 6): permit agent:update+ # Optional break-glass toggle: permit agent:update# while observing. Only meaningful for observed boxes but always storable.details = {'from': previous, 'to': mode}if 'allow_agent_update_observed' in data:@@ -92,7 +92,7 @@ def set_management_mode(server_id):@survey_bp.route('/<server_id>/observed-status', methods=['GET'])@admin_requireddef observed_status(server_id):- """Observe-mode status for a server (plan 31 #10/#11).+ """Observe-mode status for a server.Returns the current mode, the agent:update break-glass flag, and how manycommands the Observe guard has blocked — the "blocked N commands" counter.diff --git a/backend/app/api/system.py b/backend/app/api/system.pyindex 24a90e0d..89f52851 100644--- a/backend/app/api/system.py+++ b/backend/app/api/system.py@@ -294,7 +294,7 @@ def health_check():canonical_domain = SettingsService.get('canonical_domain', '') or ''https_enabled = bool(SettingsService.get('canonical_https_enabled', False))- # Staging instances (plan 37 testbed) run with SERVERKIT_STAGING set. Echo+ # Staging instances run with SERVERKIT_STAGING set. Echo# it here so the verify step can prove WHICH instance answered and the UI# can show its STAGING banner.staging = env_bool('SERVERKIT_STAGING')diff --git a/backend/app/api/templates.py b/backend/app/api/templates.pyindex 14c40299..945efc50 100644--- a/backend/app/api/templates.py+++ b/backend/app/api/templates.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). The per-app template routes gate on the shared+# Bucket: PER-APP. The per-app template routes gate on the shared# app-access seam; catalog browsing/installation stays panel-authed."""Template API Endpointsdiff --git a/backend/app/api/themes.py b/backend/app/api/themes.pyindex 3d17ce10..263d479d 100644--- a/backend/app/api/themes.py+++ b/backend/app/api/themes.py@@ -1,4 +1,4 @@-"""Themes API (plan 60) — /api/v1/themes.+"""Themes API — /api/v1/themes.A theme is data, not code: a validated map of CSS custom-property tokens. Thisblueprint lists themes (bundled seeds + installed), imports a pasted/uploadeddiff --git a/backend/app/api/waf.py b/backend/app/api/waf.pyindex 0e6c0f8f..7921ed30 100644--- a/backend/app/api/waf.py+++ b/backend/app/api/waf.py@@ -1,4 +1,4 @@-# Bucket: PER-APP (plan 29 #9). Reads are scoped to callers who can access the+# Bucket: PER-APP. Reads are scoped to callers who can access the# app (can_access_app); mutations + install stay admin-only."""Per-application WAF (ModSecurity v3 + OWASP CRS) API.@@ -19,7 +19,7 @@ waf_bp = Blueprint('waf', __name__)def _get_application_or_404(app_id):- """Resolve the app and enforce read access (plan 29 #9): owner / admin / grant /+ """Resolve the app and enforce read access: owner / admin / grant /workspace member. A caller who can't access it gets the same 404 as a missingapp (sealed-from-open, no existence leak)."""application = Application.query_active().filter_by(id=app_id).first()diff --git a/backend/app/api/workspaces.py b/backend/app/api/workspaces.pyindex 86050f71..606a3fff 100644--- a/backend/app/api/workspaces.py+++ b/backend/app/api/workspaces.py@@ -4,7 +4,7 @@ from app.services.workspace_service import WorkspaceServicefrom app.services.audit_service import AuditServicefrom app.models.audit_log import AuditLog# The workspace guards now live in middleware/rbac.py so any resource blueprint-# can reuse them (plan 19 Decision 2). Re-exported here for existing callers.+# can reuse them. Re-exported here for existing callers.from app.middleware.rbac import (admin_required, get_current_user, require_workspace_access, require_workspace_role,)diff --git a/backend/app/constants.py b/backend/app/constants.pyindex 6bb22559..9a910ec4 100644--- a/backend/app/constants.py+++ b/backend/app/constants.py@@ -1,4 +1,4 @@-"""Shared wire-protocol constants (plan 77 E3).+"""Shared wire-protocol constants.``SOCKET_EVENTS`` is mirrored verbatim by ``frontend/src/constants/events.js``so a renamed event cannot fail silently — ``tests/test_socket_contract.py``@@ -28,7 +28,7 @@ SOCKET_EVENTS = {'DEPLOY_LOG': 'deploy_log','DEPLOY_STATUS': 'deploy_status',- # generalized run envelope (plan 77 E1) — one event pair for every run kind+ # generalized run envelope — one event pair for every run kind'RUN_LOG': 'run_log','RUN_STATUS': 'run_status',diff --git a/backend/app/data/survey_probe_catalog.yaml b/backend/app/data/survey_probe_catalog.yamlindex 9eea8946..8edaedd7 100644--- a/backend/app/data/survey_probe_catalog.yaml+++ b/backend/app/data/survey_probe_catalog.yaml@@ -1,4 +1,4 @@-# ServerKit survey probe catalog (plan 27, Decision 2).+# ServerKit survey probe catalog.## A VERSIONED, declarative list of every location/service the read-only survey# ("flight") looks at on a paired Linux box, and how to read it. The panel shipsdiff --git a/backend/app/exceptions.py b/backend/app/exceptions.pyindex 2b43389b..52f896b4 100644--- a/backend/app/exceptions.py+++ b/backend/app/exceptions.py@@ -92,7 +92,7 @@ class AgentOfflineError(DependencyUnavailableError):# ----------------------------------------------------------------------------# Stable codes the client translates (plan 88 §C).+# Stable codes the client translates.## The frontend (``frontend/src/services/api/errorCodes.js``) swaps the server's# English for its own translation when it knows the ``code``. A translated code@@ -110,7 +110,7 @@ class AgentOfflineError(DependencyUnavailableError):# conflict.exists "<Resource> already exists" resource# agent.offline AgentOfflineError's message -#-# Resource words are the UI's nouns (plan 88 glossary), not model names: an+# Resource words are the UI's nouns (glossary), not model names: an# ``Application`` row is a "service" to the person reading the toast.# ---------------------------------------------------------------------------diff --git a/backend/app/jobs/builtin_handlers.py b/backend/app/jobs/builtin_handlers.pyindex 973ce7b0..ea0e1446 100644--- a/backend/app/jobs/builtin_handlers.py+++ b/backend/app/jobs/builtin_handlers.py@@ -179,7 +179,7 @@ def check_update_schedules():# Resolve the extension's update service only when scheduled WP sites# actually exist — with serverkit-wordpress uninstalled there is nothing- # to run, and the bridge would raise (plan 52 Phase 5 graceful absence).+ # to run, and the bridge would raise (graceful absence).from app.services.wordpress_bridge import wp_update_servicetry:WpUpdateService = wp_update_service()@@ -377,15 +377,15 @@ def run_telemetry_retention():def run_disk_alert():- """Notify admins when the panel host's disk crosses 85% / 95%- (plan 85 §D3). On by default; ``storage.disk_alert_percent=0`` disables."""+ """Notify admins when the panel host's disk crosses 85% / 95%.+On by default; ``storage.disk_alert_percent=0`` disables."""from app.services import disk_alert_servicelevel = disk_alert_service.check()return {'level': level} if level else Nonedef run_request_metrics():- """Roll new access-log lines into per-app request metrics (plan 86 §A2).+ """Roll new access-log lines into per-app request metrics.A builtin tick, so its once-a-minute successes get the 24 h tick retentionrather than the full job retention."""@@ -394,15 +394,15 @@ def run_request_metrics():def run_slot_standby_sweep():- """Stop warm standby slots whose time is up (plan 87 §B). Stopped, not+ """Stop warm standby slots whose time is up. Stopped, notremoved: a switch back to one is a start + health gate away."""from app.services.slot_deploy_service import SlotDeployServicereturn SlotDeployService.sweep_standby() or Nonedef run_crash_loop_check():- """Count container restarts and open/resolve crash-loop incidents- (plan 86 §E1). A builtin tick: successes keep the 24 h tick retention."""+ """Count container restarts and open/resolve crash-loop incidents.+A builtin tick: successes keep the 24 h tick retention."""from app.services.crash_loop_service import CrashLoopServicereturn CrashLoopService.sweep()@@ -664,7 +664,7 @@ def seed_builtin_schedules():FLEET_DOCTOR_SCHEDULE_NAME, FLEET_DOCTOR_JOB_KIND,interval_seconds=86400, startup_delay_seconds=2400,)- # Weekly setup-health nag (plan 22) — handler registered by+ # Weekly setup-health nag — handler registered by# SetupHealthService.register_jobs() at boot.from app.services.setup_health_service import NAG_JOB_KIND, NAG_SCHEDULE_NAMEScheduledJobService.ensure(diff --git a/backend/app/jobs/consumer.py b/backend/app/jobs/consumer.pyindex 0f022b3f..d4194d25 100644--- a/backend/app/jobs/consumer.py+++ b/backend/app/jobs/consumer.py@@ -104,7 +104,7 @@ class JobConsumer:job.queue_message_id = message['id']db.session.commit()- # Live run envelope (plan 77 E1): unified jobs stream through the same+ # Live run envelope: unified jobs stream through the same# RunLogStream seam as deploys — run_log/run_status into run_job_<id>,# resumable over GET /api/v1/runs/job/<id>/logs?after_id. Handlers can# log through stream_for(job) themselves; these frames bracket the run.diff --git a/backend/app/jobs/models.py b/backend/app/jobs/models.pyindex 62e7c668..b8b98df1 100644--- a/backend/app/jobs/models.py+++ b/backend/app/jobs/models.py@@ -21,7 +21,7 @@ from app import dbclass Job(db.Model):__tablename__ = 'jobs'- # Run envelope kind (plan 77 E1): rooms/events key on (run_kind, id).+ # Run envelope kind: rooms/events key on (run_kind, id).__run_kind__ = 'job'STATUS_PENDING = 'pending'diff --git a/backend/app/jobs/thread_ownership.py b/backend/app/jobs/thread_ownership.pyindex c7a31c53..ec25824c 100644--- a/backend/app/jobs/thread_ownership.py+++ b/backend/app/jobs/thread_ownership.py@@ -18,7 +18,7 @@ LIFECYCLE_DURABLE_CANDIDATE = 'durable_candidate'THREAD_OWNERSHIP = {'app/utils/background_loop.py:start:self._run': {- 'owner': 'BackgroundLoop helper (plan 77 E5)',+ 'owner': 'BackgroundLoop helper','lifecycle': LIFECYCLE_PROCESS_LOOP,'rationale': ('The ONE spawn site for Event-stopped process polling loops; 'diff --git a/backend/app/middleware/rbac.py b/backend/app/middleware/rbac.pyindex 3b82c851..818dd22d 100644--- a/backend/app/middleware/rbac.py+++ b/backend/app/middleware/rbac.py@@ -231,7 +231,7 @@ def app_access_tier(user, application):- otherwise -> NoneThe highest tier wins. This is the single seam behind require_app_member and- the membership visibility model (plan 19 Decision 2).+ the membership visibility model."""if user.is_admin or application.user_id == user.id:return 'owner'diff --git a/backend/app/models/app_attachment.py b/backend/app/models/app_attachment.pyindex ca8a4f87..7295bad1 100644--- a/backend/app/models/app_attachment.py+++ b/backend/app/models/app_attachment.py@@ -1,4 +1,4 @@-"""An app's attachment to a service it uses (plan 86 §C2/§C4).+"""An app's attachment to a service it uses.One row per (app, kind): the app's storage bucket on a Garage instance, orthe cache / queue it uses (env references only). ``details_json``diff --git a/backend/app/models/app_request_metric.py b/backend/app/models/app_request_metric.pyindex 6a1ed3ab..c6d52f45 100644--- a/backend/app/models/app_request_metric.py+++ b/backend/app/models/app_request_metric.py@@ -1,4 +1,4 @@-"""Per-app request rollups from the timed nginx access log (plan 86 §A2).+"""Per-app request rollups from the timed nginx access log.One row per (app, level, bucket). ``level`` is ``minute`` or ``hour``; thesampler writes both on ingest, so downsampling is just a coarser bucket, not adiff --git a/backend/app/models/app_slot.py b/backend/app/models/app_slot.pyindex c094e45c..ffecf603 100644--- a/backend/app/models/app_slot.py+++ b/backend/app/models/app_slot.py@@ -1,4 +1,4 @@-"""One of an app's two deploy slots (plan 87 §B).+"""One of an app's two deploy slots.The panel updater keeps two installs, ``/opt/serverkit-a`` and ``-b``, andflips between them. An app with slot deploys enabled gets the same: rowsdiff --git a/backend/app/models/app_volume.py b/backend/app/models/app_volume.pyindex 72f725ef..b6759956 100644--- a/backend/app/models/app_volume.py+++ b/backend/app/models/app_volume.py@@ -30,7 +30,7 @@ class AppVolume(TimestampMixin, db.Model):driver = db.Column(db.String(40), nullable=False, default='local')read_only = db.Column(db.Boolean, nullable=False, default=False)size_bytes = db.Column(db.BigInteger, nullable=True) # denormalized last-measured size- declared_size = db.Column(db.String(40), nullable=True) # operator/manifest-declared size cap, e.g. "10Gi" (plan 35)+ declared_size = db.Column(db.String(40), nullable=True) # operator/manifest-declared size cap, e.g. "10Gi"# Deleting the app removes its volume rows (ORM cascade); the underlying# Docker volumes are intentionally left on disk so an app delete never nukesdiff --git a/backend/app/models/application.py b/backend/app/models/application.pyindex 0e54904e..479e7649 100644--- a/backend/app/models/application.py+++ b/backend/app/models/application.py@@ -18,7 +18,7 @@ from app.utils.ingress import (class Application(JsonColumnMixin, TimestampMixin, SoftDeleteMixin, db.Model):"""A managed app.- SOFT DELETED (plan 70). `Application.query` therefore returns TOMBSTONES —+ SOFT DELETED. `Application.query` therefore returns TOMBSTONES —read `query_active()` anywhere you mean "an app that still exists". Thatdistinction is not cosmetic here: this model drives nginx vhosts, containerlifecycles, DNS, backups and outbound registry calls, and the equivalent@@ -54,10 +54,10 @@ class Application(JsonColumnMixin, TimestampMixin, SoftDeleteMixin, db.Model):# Populated from a manifest at import, editable in Settings. NULL => no gate# (the restart falls back to a fixed wait).healthcheck_path = db.Column(db.String(255), nullable=True)- # JSON: health-gate timeout / 4xx rule and the other deploy knobs- # (plan 87). NULL = defaults; read through app.services.deploy_settings.+ # JSON: health-gate timeout / 4xx rule and the other deploy knobs.+ # NULL = defaults; read through app.services.deploy_settings.deploy_settings = db.Column(db.Text, nullable=True)- # A/B slot deploys (plan 87 §B): opt-in, and which slot is live.+ # A/B slot deploys: opt-in, and which slot is live.slot_deploys_enabled = db.Column(db.Boolean, nullable=False, server_default='0', default=False)active_slot = db.Column(db.String(1), nullable=True)@@ -95,7 +95,7 @@ class Application(JsonColumnMixin, TimestampMixin, SoftDeleteMixin, db.Model):# Traefik/Caddy). NULL is treated as the default. See app/utils/ingress.py.ingress_plane = db.Column(db.String(20), nullable=True)- # Appliance tier (plan 35): typed port declarations (JSON list of+ # Appliance tier: typed port declarations (JSON list of# {container, host, protocol, ...}) and a one-shot bootstrap-completed flag.ports = db.Column(db.Text, nullable=True)bootstrap_done = db.Column(db.Boolean, nullable=False, server_default='0', default=False)@@ -117,12 +117,12 @@ class Application(JsonColumnMixin, TimestampMixin, SoftDeleteMixin, db.Model):# the site's vhost, with bypasses for auth/admin/cart traffic. NULL/False# = off (today's behavior).micro_cache_enabled = db.Column(db.Boolean, default=False, nullable=True)- # Page-cache TTL in seconds (plan 86 §B3). NULL = the 10s default; the+ # Page-cache TTL in seconds. NULL = the 10s default; the# renderer clamps to NginxService.MICROCACHE_TTL_MAX.micro_cache_ttl = db.Column(db.Integer, nullable=True)- # Opt-in PgBouncer sidecar for a PostgreSQL engine app (plan 86 §D1).+ # Opt-in PgBouncer sidecar for a PostgreSQL engine app.pooler_enabled = db.Column(db.Boolean, nullable=True)- # Long-cache fingerprinted assets in the vhost (plan 86 §B2).+ # Long-cache fingerprinted assets in the vhost.immutable_assets = db.Column(db.Boolean, nullable=True)# Environment linkingdiff --git a/backend/app/models/backup_policy.py b/backend/app/models/backup_policy.pyindex 7362b55d..7624768b 100644--- a/backend/app/models/backup_policy.py+++ b/backend/app/models/backup_policy.py@@ -10,7 +10,7 @@ from app.models.json_column_mixin import JsonColumnMixin# folded in from the legacy BackupService so a single BackupPolicy/BackupRun# system covers all data-protection backups.#-# This is the CORE set only (plan 52 D4): extension-owned target types — e.g.+# This is the CORE set only: extension-owned target types — e.g.# 'wordpress_site', registered by the serverkit-wordpress extension at load —# come from app.services.backup_kind_registry at runtime, so an absent# extension means an absent type. The valid set at any moment is this constant@@ -70,7 +70,7 @@ class BackupPolicy(TimestampMixin, JsonColumnMixin, db.Model):# Remoteremote_copy = db.Column(db.Boolean, default=False, nullable=False)- # Restore-drill cadence (plan 23). 'off' | 'weekly' | 'monthly'. A single+ # Restore-drill cadence. 'off' | 'weekly' | 'monthly'. A single# daily sweep enqueues due drills; last_drill_* is the denormalized cache# that powers the "last proven restore" badge + doctor staleness check.drill_cadence = db.Column(db.String(12), default='off', nullable=False)diff --git a/backend/app/models/backup_run.py b/backend/app/models/backup_run.pyindex 6f065589..c5d79b2d 100644--- a/backend/app/models/backup_run.py+++ b/backend/app/models/backup_run.py@@ -44,7 +44,7 @@ class BackupRun(JsonColumnMixin, db.Model):remote_key = db.Column(db.Text, nullable=True)verified = db.Column(db.Boolean, default=False) # remote-side evidence (legacy S3 HEAD)- # Verification ladder (plan 23). 'none' → 'listed' (tar -t readable) → 'hashed'+ # Verification ladder. 'none' → 'listed' (tar -t readable) → 'hashed'# (manifest sha256 spot-check passed) → 'drilled' (a real restore drill of a# chain ending at this run succeeded). Only a drill ever sets 'drilled'.verify_level = db.Column(db.String(12), nullable=False, default='none')diff --git a/backend/app/models/dashboard.py b/backend/app/models/dashboard.pyindex 72e5055d..d82b576e 100644--- a/backend/app/models/dashboard.py+++ b/backend/app/models/dashboard.py@@ -1,4 +1,4 @@-"""Per-user dashboard boards (plan 62).+"""Per-user dashboard boards.A *board* is one tab on the dashboard — a name, an icon, and an ordered bag ofwidget instances laid out on a 12-column grid. Boards belong to a user, not todiff --git a/backend/app/models/db_snapshot.py b/backend/app/models/db_snapshot.pyindex 0260008b..eb63b98a 100644--- a/backend/app/models/db_snapshot.py+++ b/backend/app/models/db_snapshot.py@@ -3,7 +3,7 @@ Database snapshot & sync-job models.These are generic database point-in-time snapshot and environment-syncrecords. They physically lived in ``wordpress_site.py`` historically; they were-relocated here (plan 52 Phase 1) so the WordPress model file no longer owns+relocated here so the WordPress model file no longer ownsgeneric machinery. The tables (``database_snapshots``, ``sync_jobs``) areunchanged — this was a pure module move. Their foreign keys still reference``wordpress_sites`` (the only environment kind that uses them today); that is adiff --git a/backend/app/models/deployment.py b/backend/app/models/deployment.pyindex 4627e819..757df74a 100644--- a/backend/app/models/deployment.py+++ b/backend/app/models/deployment.py@@ -146,7 +146,7 @@ class Deployment(JsonColumnMixin, db.Model):A deploy marks the release it replaces ``rolled_back``, so "was liveonce" is live-or-rolled_back with a completed deploy. Matching only``live`` found nothing for any app deployed twice: rollback without a- version always failed and no diff was ever generated (plan 87 §A6).+ version always failed and no diff was ever generated."""return cls.query.filter(cls.app_id == app_id,diff --git a/backend/app/models/deployment_job.py b/backend/app/models/deployment_job.pyindex 5e742795..69fc8d0f 100644--- a/backend/app/models/deployment_job.py+++ b/backend/app/models/deployment_job.py@@ -16,10 +16,10 @@ class DeploymentJob(RunLifecycleMixin, JsonColumnMixin, db.Model):__tablename__ = 'deployment_jobs'- # Run envelope kind (plan 77 E1): rooms/events key on (run_kind, id).+ # Run envelope kind: rooms/events key on (run_kind, id).__run_kind__ = 'deploy'- # Stored spelling predates the canonical vocabulary (plan 77 D1);+ # Stored spelling predates the canonical vocabulary;# override until this domain's data migration rewrites 'succeeded'.__status_success__ = 'succeeded'__error_attr__ = 'error_message'diff --git a/backend/app/models/dns_cutover_snapshot.py b/backend/app/models/dns_cutover_snapshot.pyindex a74aa57a..81791804 100644--- a/backend/app/models/dns_cutover_snapshot.py+++ b/backend/app/models/dns_cutover_snapshot.py@@ -7,7 +7,7 @@ from app.models.json_column_mixin import JsonColumnMixinclass DnsCutoverSnapshot(JsonColumnMixin, db.Model):"""A point-in-time capture of a domain's live DNS records, taken right before- a migration cutover flips them to the new box (plan 27 Phase 6 #13, Decision 6).+ a migration cutover flips them to the new box.ServerKit's DNS activity ledger (:class:`~app.models.dns_change.DnsChange`)only records the *after* value of each write, so it cannot power a revert. A@@ -21,7 +21,7 @@ class DnsCutoverSnapshot(JsonColumnMixin, db.Model):* **cutover** — the record(s) were repointed at the new box.* **reverted** — the snapshot was re-applied, restoring the pre-cutover state.* **reverted_with_deletions** — as *reverted*, plus records the cutover- *created* (no predecessor in the snapshot) were deleted (plan 31 #3).+ *created* (no predecessor in the snapshot) were deleted."""__tablename__ = 'dns_cutover_snapshots'@@ -36,7 +36,7 @@ class DnsCutoverSnapshot(JsonColumnMixin, db.Model):# JSON list of the records captured before cutover (the world to restore).records_json = db.Column(db.Text, nullable=True)# JSON list of records the cutover CREATED (no snapshot predecessor); revert- # deletes these so the world is restored byte-for-byte (plan 31 #3).+ # deletes these so the world is restored byte-for-byte.created_records_json = db.Column(db.Text, nullable=True)status = db.Column(db.String(24), nullable=False, default='captured')diff --git a/backend/app/models/email.py b/backend/app/models/email.pyindex 20addfa5..e8224109 100644--- a/backend/app/models/email.py+++ b/backend/app/models/email.py@@ -143,7 +143,7 @@ class DNSProviderConfig(db.Model):api_email = db.Column(db.String(255))is_default = db.Column(db.Boolean, default=False)# Cloudflare Origin CA — the private key the panel generated for the CSR when- # issuing an Origin certificate for this provider's zones (plan 36 Origin CA).+ # issuing an Origin certificate for this provider's zones.origin_ca_key = db.Column(db.Text, nullable=True)created_at = db.Column(db.DateTime, default=datetime.utcnow)diff --git a/backend/app/models/email_bounce.py b/backend/app/models/email_bounce.pyindex 4c5bc7a5..03749f3f 100644--- a/backend/app/models/email_bounce.py+++ b/backend/app/models/email_bounce.py@@ -1,4 +1,4 @@-"""Email bounce / complaint suppression state (plan 33 Phase 4, roadmap #24).+"""Email bounce / complaint suppression state (roadmap #24).One row per email address that a provider reported a bounce or complaint for.A hard-bouncing address auto-mutes after ``MUTE_THRESHOLD`` consecutive harddiff --git a/backend/app/models/env_variable.py b/backend/app/models/env_variable.pyindex 91d1bcaa..5494381b 100644--- a/backend/app/models/env_variable.py+++ b/backend/app/models/env_variable.py@@ -43,7 +43,7 @@ class EnvironmentVariable(TimestampMixin, JsonColumnMixin, db.Model):db.UniqueConstraint('application_id', 'key', name='unique_app_env_key'),)- # One crypto path (plan 77 C2): new writes encrypt via utils/crypto+ # One crypto path: new writes encrypt via utils/crypto# (SERVERKIT_ENCRYPTION_KEY). Reads dual-read: the one path first, then# the legacy SECRET_KEY-derived Fernet this model historically used —# rows written before the fold-in decrypt forever without a bulkdiff --git a/backend/app/models/fleet_doctor_result.py b/backend/app/models/fleet_doctor_result.pyindex 87e97782..164fa7d6 100644--- a/backend/app/models/fleet_doctor_result.py+++ b/backend/app/models/fleet_doctor_result.py@@ -7,7 +7,7 @@ from app.models.json_column_mixin import JsonColumnMixinclass FleetDoctorResult(JsonColumnMixin, db.Model):"""One row per ``(server_id, check_key)`` recorded by the fleet health sweep- (Fleet Parity Sweep, plan 26 Phase 2, Decision 3).+ (Fleet Parity Sweep).The panel-host doctor keeps its ``doctor_last_report`` settings blob; thefleet sweep instead records each remote server's per-check outcome as a ROWdiff --git a/backend/app/models/json_column_mixin.py b/backend/app/models/json_column_mixin.pyindex c14f63d8..947521ca 100644--- a/backend/app/models/json_column_mixin.py+++ b/backend/app/models/json_column_mixin.py@@ -1,4 +1,4 @@-"""One implementation of the JSON-in-a-Text-column accessor pattern (plan 75 §F2).+"""One implementation of the JSON-in-a-Text-column accessor pattern.Dozens of models hand-roll the same pair over a ``db.Text`` column:@@ -25,7 +25,7 @@ optional shape check, falsy-on-write.Corrupt JSON reads as the default, never raises: a hand-edited orpartially-written row must not 500 every endpoint that serializes the model.-This is the tree-wide convention as of plan 77 B4, which reversed the earlier+This is the tree-wide convention, which reversed the earlierruling that unprotected ``json.loads`` sites were out of scope: the sites thatused to let corrupt data raise were converted too, so a corrupt row nowdegrades to the accessor's default instead of failing every request thatdiff --git a/backend/app/models/linked_panel.py b/backend/app/models/linked_panel.pyindex 7a6d4215..7df4f4ff 100644--- a/backend/app/models/linked_panel.py+++ b/backend/app/models/linked_panel.py@@ -33,7 +33,7 @@ class LinkedPanelConfig(TimestampMixin, db.Model):remote_server_name = db.Column(db.String(120), nullable=True)enabled = db.Column(db.Boolean, default=True, nullable=False)- # One crypto path (plan 77 C1). legacy_plaintext: rows written before+ # One crypto path. legacy_plaintext: rows written before# encryption-at-rest read back unchanged until rewritten.api_secret = EncryptedSecret('api_secret_encrypted', legacy_plaintext=True)diff --git a/backend/app/models/managed_database.py b/backend/app/models/managed_database.pyindex 3dbf405b..02b4d015 100644--- a/backend/app/models/managed_database.py+++ b/backend/app/models/managed_database.py@@ -19,7 +19,7 @@ class ManagedDatabase(SoftDeleteMixin, db.Model):``SourceConnection``); it is masked in API responses and revealed only throughan explicit, audited action.- Soft-deletable (plan 77 B5): a plain delete tombstones the row into the+ Soft-deletable: a plain delete tombstones the row into theRecycle Bin — the actual database server-side is untouched and any managedbackup policy keeps running, so restore brings everything back intact. Theexplicit ``?drop=true`` path stays immediately destructive. Read paths usediff --git a/backend/app/models/mixins.py b/backend/app/models/mixins.pyindex e3c07b83..e6086c56 100644--- a/backend/app/models/mixins.py+++ b/backend/app/models/mixins.py@@ -99,7 +99,7 @@ class EncryptedSecret:server.api_secret # decrypts; None when empty or undecryptableServer.api_secret.is_set(server) # has-a-secret masking for to_dict()- Contracts (plan 77 C1):+ Contracts:- **Assignment raises on encrypt failure.** The historical hand-rolledaccessors caught the exception and ``print()``-ed it, silently storing@@ -158,7 +158,7 @@ class EncryptedSecret:def uuid_pk():"""The ONE uuid primary-key shape: String(36), dashed uuid4 text.- Every uuid-keyed model uses this factory (plan 77 B3) so the format+ Every uuid-keyed model uses this factory so the formatdecision is made once — a second format (e.g. 32-char hex) would breakFK joins against String(36) columns. The lone pre-existing deviant isai.py's String(64) hex ids, grandfathered until a data migration.@@ -170,7 +170,7 @@ def uuid_pk():class TimestampMixin:- """created_at / updated_at in the ONE house shape (plan 77 B1).+ """created_at / updated_at in the ONE house shape.Byte-identical to the hand-written pair::@@ -200,7 +200,7 @@ class TimestampMixin:class RunLifecycleMixin:- """State transitions for run-shaped models (plan 77 D2).+ """State transitions for run-shaped models.Ten run models hand-write ``status`` + ``started_at``/``completed_at``(+ duration) transitions today; this mixin is the one place they happen::@@ -260,14 +260,14 @@ class RunLifecycleMixin:class SerializableMixin:"""Opt-in ``to_dict()`` for models whose serialization is purely- mechanical (plan 77 B2).+ mechanical.Introspects ``__table__.columns``: DateTime values auto-isoformat (theternary previously pasted ~266 times), ``*_encrypted`` columns and anyname in ``__serialize_exclude__`` are dropped, and ``serialize_extra()`` mergescomputed fields on top. A model whose dict genuinely differs from itscolumns (renames, nesting, per-caller options) keeps its hand-written- ``to_dict`` — this mixin is never forced (plan 75 §F's ruling stands).+ ``to_dict`` — this mixin is never forced.Interplay with api/_query.py field selection: the mixin produces theFULL dict; response shaping stays _query's job.diff --git a/backend/app/models/notification_preferences.py b/backend/app/models/notification_preferences.pyindex 3913923a..896f63cc 100644--- a/backend/app/models/notification_preferences.py+++ b/backend/app/models/notification_preferences.py@@ -41,14 +41,14 @@ class NotificationPreferences(TimestampMixin, JsonColumnMixin, db.Model):# JSON object with category: booleancategories = db.Column(db.Text, default='{"system": true, "security": true, "backups": true, "apps": true}')- # Digest rollup cadence (plan 24 Phase 3): 'off' | 'daily' | 'weekly'.+ # Digest rollup cadence: 'off' | 'daily' | 'weekly'.# Default 'off' preserves immediate-send back-compat (digests are opt-in).# Backed by migration 060; the digest job (app/notifications/digest.py)# batches this user's `queued_digest` deliveries into one branded email.digest_cadence = db.Column(db.String(12), default='off')digest_last_sent_at = db.Column(db.DateTime, nullable=True)- # Per-event channel overrides (plan 24 Phase 2):+ # Per-event channel overrides:# {"<event_key>": {"<channel>": bool}}. The resolution/catalog surface was# lost in the 2026-07 data loss; the column stays mapped so migration# 059's data survives and the schema matches the migrationsdiff --git a/backend/app/models/plugin.py b/backend/app/models/plugin.pyindex a554acf2..c3a73aa0 100644--- a/backend/app/models/plugin.py+++ b/backend/app/models/plugin.py@@ -110,7 +110,7 @@ class InstalledPlugin(JsonColumnMixin, db.Model):# Schema only — saved VALUES may hold secrets and are served# exclusively by the admin-gated /config endpoint.'config_schema': manifest.get('config_schema') or {},- # Install-time signature verdict (plan 55): None for sources that+ # Install-time signature verdict: None for sources that# predate stamping, else {status: verified|untrusted_key|unsigned,# key_id?, publisher?}. Panel-managed (reserved config key).'signature': (self.config or {}).get('_signature'),diff --git a/backend/app/models/run_log.py b/backend/app/models/run_log.pyindex f841a23b..e5eb45a9 100644--- a/backend/app/models/run_log.py+++ b/backend/app/models/run_log.py@@ -1,4 +1,4 @@-"""Generic run-scoped log rows (plan 77 E1).+"""Generic run-scoped log rows.``DeploymentJobLog`` predates this table and stays the store for the deploykind; every OTHER run kind (unified jobs, sandbox runs, site imports,diff --git a/backend/app/models/server.py b/backend/app/models/server.pyindex 8ce27987..6816268c 100644--- a/backend/app/models/server.py+++ b/backend/app/models/server.py@@ -111,10 +111,10 @@ class Server(TimestampMixin, JsonColumnMixin, db.Model):auto_upgrade = db.Column(db.Boolean, default=False)upgrade_channel = db.Column(db.String(20), default='stable') # stable, beta- # Managed vs observed (plan 27 D1, plan 31 #10). Migrations 065/068 have+ # Managed vs observed. Migrations 065/068 have# always carried these columns; the model fields and MANAGEMENT_MODES were# lost in the 2026-07 data loss, which left the survey management-mode- # routes raising AttributeError (restored via plan 82's migration↔model+ # routes raising AttributeError (restored via the migration↔model# drift gate). Observed boxes refuse mutating agent commands;# allow_agent_update_observed is the explicit break-glass that still# permits agent:update on an observed box.@@ -126,7 +126,7 @@ class Server(TimestampMixin, JsonColumnMixin, db.Model):@propertydef is_managed(self):- """False only for observed boxes (plan 27 D1)."""+ """False only for observed boxes."""return (self.management_mode or 'managed') != 'observed'# System Info (reported by agent)@@ -156,7 +156,7 @@ class Server(TimestampMixin, JsonColumnMixin, db.Model):api_key_pending_prefix = db.Column(db.String(12)) # Prefix of pending new API keyapi_secret_pending_encrypted = db.Column(db.Text) # Encrypted pending new API secret- # One crypto path (plan 77 C1): descriptor-backed accessors over the+ # One crypto path: descriptor-backed accessors over the# *_encrypted columns. Encrypt failures RAISE (the old accessors printed# and silently stored nothing — a data-loss path).api_secret = EncryptedSecret('api_secret_encrypted')@@ -343,7 +343,7 @@ class Server(TimestampMixin, JsonColumnMixin, db.Model):'read', 'get', 'inspect', 'status', 'info','search', 'logs', 'stats', 'available','installed', 'current', 'show',- # Fleet doctor / survey probes are Observed-safe reads (plan 28 #7):+ # Fleet doctor / survey probes are Observed-safe reads:# they only discover host state, so they classify as reads and expand# to `<ns>:read` rather than `<ns>:write`.'probe', 'survey',diff --git a/backend/app/models/server_survey.py b/backend/app/models/server_survey.pyindex 721c082f..cdde090e 100644--- a/backend/app/models/server_survey.py+++ b/backend/app/models/server_survey.py@@ -6,8 +6,7 @@ from app.models.json_column_mixin import JsonColumnMixinclass ServerSurvey(JsonColumnMixin, db.Model):- """One read-only survey snapshot ("flight") of a paired server (plan 27,- Decision 3: snapshots, not live state).+ """One read-only survey snapshot ("flight") of a paired server (snapshots, not live state).The agent flies the probe catalog and returns a structured Server Map; thepanel normalizes it and stores it here as a versioned, immutable snapshot.diff --git a/backend/app/models/status.py b/backend/app/models/status.pyindex 222ffe27..b1566360 100644--- a/backend/app/models/status.py+++ b/backend/app/models/status.py@@ -1,4 +1,4 @@-"""The ONE status vocabulary for run-shaped models (plan 77 D1).+"""The ONE status vocabulary for run-shaped models.The same terminal state has historically been spelled four ways across runmodels (``success`` in cron_run/backup_run, ``completed`` in db_snapshot anddiff --git a/backend/app/models/system_settings.py b/backend/app/models/system_settings.pyindex a702bc95..7bfb8614 100644--- a/backend/app/models/system_settings.py+++ b/backend/app/models/system_settings.py@@ -27,7 +27,7 @@ class SystemSettings(JsonColumnMixin, db.Model):if self.value_type == 'integer':return int(self.value)if self.value_type == 'json':- # Corrupt JSON degrades to None instead of raising (plan 77 B4).+ # Corrupt JSON degrades to None instead of raising.return self._json_read('value', None)return self.valuediff --git a/backend/app/models/theme.py b/backend/app/models/theme.pyindex 84a6afb8..7a6fb38f 100644--- a/backend/app/models/theme.py+++ b/backend/app/models/theme.py@@ -1,4 +1,4 @@-"""Theme model (plan 60).+"""Theme model.A theme is DATA, not code: a validated map of CSS custom-property tokens plusgallery metadata. Installed themes (imported, studio-authored, or pulled fromdiff --git a/backend/app/models/user.py b/backend/app/models/user.pyindex 294adc0b..eac0d61c 100644--- a/backend/app/models/user.py+++ b/backend/app/models/user.py@@ -49,14 +49,14 @@ class User(JsonColumnMixin, db.Model):# Sidebar preferences: { preset: 'full'|'web'|'email'|'devops'|'minimal'|'custom', hiddenItems: [...] }sidebar_config = db.Column(db.Text, nullable=True)- # Preferred UI language as a BCP-47 language code (plan 79 B2). NULL means+ # Preferred UI language as a BCP-47 language code. NULL means# "follow the panel default", which is a genuinely different state from an# explicit choice of English -- the same distinction ThemeContext draws# between an inherited skin and a picked one.language = db.Column(db.String(10), nullable=True)- # Per-user Setup Health item snoozes: JSON { item_key: iso_expiry } (plan 22- # Phase 6). Panel-item snoozes live in a SettingsService map instead.+ # Per-user Setup Health item snoozes: JSON { item_key: iso_expiry }.+ # Panel-item snoozes live in a SettingsService map instead.setup_snoozes = db.Column(db.Text, nullable=True)# Relationshipsdiff --git a/backend/app/models/wordpress_site.py b/backend/app/models/wordpress_site.pyindex 24b4feef..a009b815 100644--- a/backend/app/models/wordpress_site.py+++ b/backend/app/models/wordpress_site.py@@ -13,7 +13,7 @@ from app.models.json_column_mixin import JsonColumnMixinfrom app.models.mixins import TimestampMixin, SerializableMixin# DatabaseSnapshot + SyncJob were relocated to app/models/db_snapshot.py-# (plan 52 Phase 1 — generic snapshot/sync machinery no longer owned by the WP+# (generic snapshot/sync machinery no longer owned by the WP# model file). Re-exported here so existing# `from app.models.wordpress_site import DatabaseSnapshot` (and SyncJob) callers# keep working, and so WordPressSite.to_dict can reference DatabaseSnapshot.diff --git a/backend/app/notifications/catalog.py b/backend/app/notifications/catalog.pyindex 412b331a..c3c617b1 100644--- a/backend/app/notifications/catalog.py+++ b/backend/app/notifications/catalog.py@@ -41,7 +41,7 @@ _CATALOG = {'severity': 'critical','category': 'backups',},- # Restore-proof edge alerts (plan 23 #17): fire once on a state transition+ # Restore-proof edge alerts: fire once on a state transition# when a restore drill or backup verification starts failing / recovers.'backup.drill_failed': {'title': 'Restore drill failed: {target}',@@ -81,7 +81,7 @@ _CATALOG = {'severity': 'success','category': 'apps',},- # Slot deploys (plan 87): a release that never went live, one that was+ # Slot deploys: a release that never went live, one that was# switched back automatically, and a switch back that did not work.'app.deploy_aborted': {'title': 'Deploy stopped, site unchanged: {app}',@@ -114,7 +114,7 @@ _CATALOG = {'category': 'system',},# The panel host's own hardware moved between boots — a VPS resize, a- # volume attached or detached (plan 74). Informational: the operator+ # volume attached or detached. Informational: the operator# usually caused it, but until now nothing confirmed it landed.'host.specs_changed': {'title': "This server's hardware changed",@@ -219,7 +219,7 @@ DEFAULT_ENTRY = {# --------------------------------------------------------------------------- #-# Deep links (plan 24 Phase 5)+# Deep links## Maps an ``event_key`` to the relative in-app path its notification should link# to. Resolved at send time and PERSISTED on the notification row (seediff --git a/backend/app/notifications/channels/chat.py b/backend/app/notifications/channels/chat.pyindex 7a7c241e..31adc11e 100644--- a/backend/app/notifications/channels/chat.py+++ b/backend/app/notifications/channels/chat.py@@ -38,7 +38,7 @@ class ChatAdapter(ChannelAdapter):def deliver(self, delivery, notification):target = (delivery.target or '').strip()- # Org-level chat/webhook connections (plan 24 Phase 4) address their+ # Org-level chat/webhook connections address their# destination as ``conn:<id>`` — resolve + deliver via the connection# service (encrypted creds, HMAC signing, per-connection category).if target.startswith('conn:'):diff --git a/backend/app/notifications/channels/email.py b/backend/app/notifications/channels/email.pyindex 66624468..127b0c7d 100644--- a/backend/app/notifications/channels/email.py+++ b/backend/app/notifications/channels/email.py@@ -52,7 +52,7 @@ class EmailAdapter(ChannelAdapter):return DeliveryResult.skipped('no email target')# A hard-bouncing / complained address is suppressed until unmuted- # (plan 33 Phase 4, roadmap #24). Fed by the inbound bounce webhook.+ # (roadmap #24). Fed by the inbound bounce webhook.from app.services.bounce_service import BounceServiceif BounceService.is_muted(to_addr):return DeliveryResult.skipped('address muted (bouncing)')diff --git a/backend/app/notifications/digest.py b/backend/app/notifications/digest.pyindex f8fde66e..f946ba58 100644--- a/backend/app/notifications/digest.py+++ b/backend/app/notifications/digest.py@@ -1,4 +1,4 @@-"""Notification digest rollups — per-user cadence (plan 24 Phase 3).+"""Notification digest rollups — per-user cadence.Instead of one email per event, a user can opt into a *digest*: the bus routesdigestable deliveries (and quiet-hours catch-ups) onto thediff --git a/backend/app/notifications/links.py b/backend/app/notifications/links.pyindex fc43e957..740851b0 100644--- a/backend/app/notifications/links.py+++ b/backend/app/notifications/links.py@@ -1,4 +1,4 @@-"""Deep-link helpers for notifications (plan 24).+"""Deep-link helpers for notifications.A notification's ``action_path`` is stored relative (e.g. ``/domains``) so aroute move never breaks old rows. For channels that need an absolute URL (email,diff --git a/backend/app/notifications/models.py b/backend/app/notifications/models.pyindex 2552db20..92a25be7 100644--- a/backend/app/notifications/models.py+++ b/backend/app/notifications/models.py@@ -46,7 +46,7 @@ class Notification(db.Model):# (e.g. 'admins', 'user:42', '[email protected]'). Not used for routing.audience = db.Column(db.String(255))- # Deep link to this notification's subject (plan 24 Phase 5). Stored RELATIVE+ # Deep link to this notification's subject. Stored RELATIVE# (e.g. '/domains') and computed at send time — from the catalog link builder# or a producer override — so a later route move never breaks old rows. The# bell/history navigate here; email/chat resolve it to an absolute URL.@@ -104,7 +104,7 @@ class NotificationDelivery(db.Model):STATUS_SENT = 'sent' # handed to the channel successfullySTATUS_FAILED = 'failed' # exhausted retries (dead-letter on the queue)STATUS_SKIPPED = 'skipped' # intentionally not sent (e.g. no target)- # Held for the periodic digest (plan 24 Phase 3): a digestable email or a+ # Held for the periodic digest: a digestable email or a# quiet-hours catch-up. Never enqueued; the digest job groups these, sends# ONE branded email, then flips them to STATUS_SENT.STATUS_QUEUED_DIGEST = 'queued_digest'diff --git a/backend/app/notifications/service.py b/backend/app/notifications/service.pyindex e3d629c0..75aaa9be 100644--- a/backend/app/notifications/service.py+++ b/backend/app/notifications/service.py@@ -125,7 +125,7 @@ class NotificationBusService:to_enqueue.append(delivery)db.session.add(delivery)- # Org-level chat/webhook connections (plan 24 Phase 4). A preference-+ # Org-level chat/webhook connections. A preference-# driven notification (channels is None) fans out ONCE per active,# category-matched connection as an org-level delivery (no recipient# user). Directed transactional sends (explicit channels) arediff --git a/backend/app/plugins/serverkit-status/__init__.py b/backend/app/plugins/serverkit-status/__init__.pyindex 5087b60e..f04248b0 100644--- a/backend/app/plugins/serverkit-status/__init__.py+++ b/backend/app/plugins/serverkit-status/__init__.py@@ -1,6 +1,6 @@"""ServerKit Status Pages extension backend package.-Extracted from core (plan 47): the status-pages blueprint (public status/badge+Extracted from core: the status-pages blueprint (public status/badgeroutes + authenticated management API) and its service ship here so a fresh panelthat never publishes a status page loads none of it. Mounted under``/api/v1/status`` via the manifest's ``url_prefix``; the public /status/<slug>diff --git a/backend/app/plugins_sdk/permissions.py b/backend/app/plugins_sdk/permissions.pyindex 42173bc2..314d5fd7 100644--- a/backend/app/plugins_sdk/permissions.py+++ b/backend/app/plugins_sdk/permissions.py@@ -50,7 +50,7 @@ class PermissionDenied(PermissionError):# ----------------------------------------------------------------------------# Usage observation (plan 55 task 7)+# Usage observation (task 7)## In-memory and per-process on purpose: this answers "what has this extension# actually done since the panel started", which is a live-process question. Itdiff --git a/backend/app/services/agent_registry.py b/backend/app/services/agent_registry.pyindex 11341e42..74e3ec4c 100644--- a/backend/app/services/agent_registry.py+++ b/backend/app/services/agent_registry.py@@ -26,10 +26,10 @@ from app.models.server import Server, ServerCommand, AgentSession# ---------------------------------------------------------------------------# Per-IP auth rate limiter — transport-neutral state shared by the WS# namespace and the long-poll /connect endpoint (moved here from-# agent_gateway in plan 77 A2 so the handshake door owns its own throttle).+# agent_gateway so the handshake door owns its own throttle).# Guarded by a lock: async_mode='threading' means both transports can call# concurrently. Buckets are swept so one-off IPs don't accumulate forever.-# request.remote_addr upstream is the ProxyFix-corrected client IP (plan 48).+# request.remote_addr upstream is the ProxyFix-corrected client IP.# ---------------------------------------------------------------------------_auth_attempts = defaultdict(list)_auth_attempts_lock = threading.Lock()@@ -151,10 +151,10 @@ class AgentRegistry:# Connected agents by server_idself._agents: Dict[str, ConnectedAgent] = {}- # Commands refused by the Observe guard per server (plan 31 #11's+ # Commands refused by the Observe guard per server (the# "blocked N commands" counter). In-memory like all registry state —# single-worker by architecture. The dispatch-level guard itself is- # still hollow post-loss (plan 82 §H); until it is restored the+ # still hollow post-loss; until it is restored the# counter only grows where callers record blocks explicitly.self._observed_blocks: Dict[str, int] = {}# Socket ID to server ID mapping@@ -489,7 +489,7 @@ class AgentRegistry:self._observed_blocks.get(server_id, 0) + 1)def observed_blocked_count(self, server_id: str) -> int:- """Commands the Observe guard refused for this server (plan 31 #11)."""+ """Commands the Observe guard refused for this server."""with self._lock:return self._observed_blocks.get(server_id, 0)@@ -792,7 +792,7 @@ class AgentRegistry:# ==================== Authentication ====================# ------------------------------------------------------------------- # Transport-neutral handshake + state ingest (plan 77 A2). The WS+ # Transport-neutral handshake + state ingest. The WS# namespace (agent_gateway) and the long-poll endpoints (api/agent_poll)# are thin adapters over these two doors; neither may re-implement the# sequence (ratcheted by tests/test_agent_handshake_matrix.py).@@ -1126,7 +1126,7 @@ class AgentRegistry:returntry:# TunnelBrokerService lives in the serverkit-remote-access- # extension (plan 47); reach it only when installed, no-op+ # extension; reach it only when installed, no-op# otherwise.from app.services.plugin_service import get_installed_extension_attrTunnelBrokerService = get_installed_extension_attr(diff --git a/backend/app/services/app_attachment_service.py b/backend/app/services/app_attachment_service.pyindex 0117ac34..3df7bfad 100644--- a/backend/app/services/app_attachment_service.py+++ b/backend/app/services/app_attachment_service.py@@ -1,4 +1,4 @@-"""Attach a service an app uses: storage, cache or queue (plan 86 §C2/§C4).+"""Attach a service an app uses: storage, cache or queue.Cache and queue attachments are env references only: the app gets theservice's C1 ``url`` through ``fromService`` under the names its libraries@@ -85,7 +85,7 @@ def _is_loki(template, engine):return template.get('id') == 'loki'-# Kinds that provision a data source on a Grafana consumer (plan 86 §A4)+# Kinds that provision a data source on a Grafana consumer# instead of writing env; which service types each accepts.GRAFANA_KINDS = {'metrics': _is_prometheus, 'logs': _is_loki}@@ -94,7 +94,7 @@ CONNECTION_KINDS = {'cache': [(_is_redis, {'REDIS_URL': 'url'})],'queue': [(_is_amqp, {'AMQP_URL': 'url', 'BROKER_URL': 'url'}),(_is_redis, {'BROKER_URL': 'url'})],- # The standard OpenTelemetry SDK variables (plan 86 §A4).+ # The standard OpenTelemetry SDK variables.'tracing': [(_is_otel_collector, {'OTEL_EXPORTER_OTLP_ENDPOINT': 'otlpEndpoint','OTEL_EXPORTER_OTLP_PROTOCOL': '=http/protobuf'})],# Collector -> trace store; read by the collector template's config.@@ -104,7 +104,7 @@ CONNECTION_KINDS = {# Kinds only one consumer template can take.CONSUMER_ONLY = {'traces': 'otel-collector'}-# One line per kind, shown where the operator decides (plan 86 §C4).+# One line per kind, shown where the operator decides.FAILURE_MODES = {'storage': 'Objects outlive the app: detaching keeps the bucket and its data.','cache': 'Cached data can be stale; invalidate on write, and never keep the only copy in a cache.',diff --git a/backend/app/services/app_image_retention.py b/backend/app/services/app_image_retention.pyindex 2639f88d..7dfe5618 100644--- a/backend/app/services/app_image_retention.py+++ b/backend/app/services/app_image_retention.py@@ -1,4 +1,4 @@-"""Immutable per-deployment image tags and their retention (plan 87 §A1).+"""Immutable per-deployment image tags and their retention.Every build used to be tagged ``serverkit-app-<id>:latest``, so "roll back tov11" re-ran ``:latest`` — the image v12 had just overwritten — and rolled@@ -7,7 +7,7 @@ forward instead. A deploy now builds ``serverkit-app-<id>:d<deployment id>``the deployment keeps that tag, and a rollback runs the image that actuallyran.-The price is images per deploy, and plan 85 is about exactly that kind of+The price is images per deploy, and disk headroom is about exactly that kind ofleak, so they are pruned on every successful deploy: images of the newest``keep`` deployments stay, plus anything a slot or the live deployment stillreferences. ``docker rmi`` without ``-f`` refuses an image a container isdiff --git a/backend/app/services/app_port_service.py b/backend/app/services/app_port_service.pyindex 17654721..508a9eb2 100644--- a/backend/app/services/app_port_service.py+++ b/backend/app/services/app_port_service.py@@ -1,4 +1,4 @@-"""Appliance-tier typed L4 port publishes (plan 35).+"""Appliance-tier typed L4 port publishes.Ports declared in a serverkit.yaml ``ports:`` list are persisted as a JSON liston ``Application.ports`` and rendered as raw docker publishes at deploy time.diff --git a/backend/app/services/application_lifecycle_service.py b/backend/app/services/application_lifecycle_service.pyindex 6f2f840f..0341ab1a 100644--- a/backend/app/services/application_lifecycle_service.py+++ b/backend/app/services/application_lifecycle_service.py@@ -72,7 +72,7 @@ def _is_single_container_app(app):if app.server_id or app.compose_file or not app.root_path:return Falseif getattr(app, 'slot_deploys_enabled', False) and app.active_slot:- return True # a slot app runs one live container (plan 87)+ return True # a slot app runs one live containerif not app.buildpack_type:return Falsereturn not any(@@ -83,7 +83,7 @@ def _is_single_container_app(app):def _is_slot_compose_app(app):- """A compose app on A/B slots (plan 87): its live release is the slot+ """A compose app on A/B slots: its live release is the slotproject, not the project the app's own compose file would name."""from app.services.slot_deploy_service import SlotDeployServicereturn SlotDeployService.is_compose_slot_app(app)@@ -93,7 +93,7 @@ def _app_container_name(app):"""The single container serving this app.``serverkit-app-<id>`` for an in-place deploy (``DeploymentService.- _deploy_docker``); the live slot's container for a slot app (plan 87).+ _deploy_docker``); the live slot's container for a slot app."""from app.services.slot_deploy_service import live_container_namereturn live_container_name(app)diff --git a/backend/app/services/backup_alert_service.py b/backend/app/services/backup_alert_service.pyindex 4c56c885..67839de9 100644--- a/backend/app/services/backup_alert_service.py+++ b/backend/app/services/backup_alert_service.py@@ -1,4 +1,4 @@-"""Edge-triggered restore-proof alerts (plan 23 Phase 5).+"""Edge-triggered restore-proof alerts.Drills and verification run on a schedule, so a naive "notify on failure" wouldre-alert every sweep. These alerts are STATE-TRANSITION only: a failure fires@@ -47,7 +47,7 @@ class BackupAlertService:@staticmethoddef _notify(event, data, policy=None):# Carry the policy target so the notification deep-links straight to its- # protection panel (focus=policy:<target_type>:<target_id>, plan 33).+ # protection panel (focus=policy:<target_type>:<target_id>).if policy is not None:data = {**data, 'target_type': policy.target_type, 'target_id': policy.target_id}try:diff --git a/backend/app/services/backup_drill_service.py b/backend/app/services/backup_drill_service.pyindex 0b4a4a3f..890df702 100644--- a/backend/app/services/backup_drill_service.py+++ b/backend/app/services/backup_drill_service.py@@ -1,4 +1,4 @@-"""Restore-drill engine (plan 23 Phases 2–3).+"""Restore-drill engine.A *drill* is a real restore of a policy's latest restorable point into a scratchlocation (a temp dir for files/application, a throwaway ``skdrill_<run_id>``@@ -520,7 +520,7 @@ class BackupDrillService:}# ------------------------------------------------------------------ #- # WordPress leg (files drill + real scratch-DB import, plan 30)+ # WordPress leg (files drill + real scratch-DB import)# ------------------------------------------------------------------ #@classmethod@@ -528,7 +528,7 @@ class BackupDrillService:"""A WordPress drill proves BOTH halves: extract the files archive into ascratch dir, AND import ``database.sql`` into a throwaway scratch DB. Adrill that verified neither artifact fails instead of earning 'drilled'- vacuously (plan 30)."""+ vacuously."""import tarfilefrom app.services.backup_service import BackupServicefrom app.services.database_service import DatabaseServicediff --git a/backend/app/services/backup_kind_registry.py b/backend/app/services/backup_kind_registry.pyindex b41f3069..c0fc1f73 100644--- a/backend/app/services/backup_kind_registry.py+++ b/backend/app/services/backup_kind_registry.py@@ -48,7 +48,7 @@ def register(target_type: str, resolve, execute, restore=None, replace: bool = FNamespace it after your plugin (``minecraft.world``); the bare words coreuses are reserved. ('wordpress_site' is the WordPress extension's kind —- it left the core set under plan 52 D4.)+ it left the core set.)``label`` / ``restore_scopes`` are optional UI metadata surfaced by``GET /api/v1/backups/target-types`` so the Protection panel/restorediff --git a/backend/app/services/backup_offsite_service.py b/backend/app/services/backup_offsite_service.pyindex 15f19e2e..744267a4 100644--- a/backend/app/services/backup_offsite_service.py+++ b/backend/app/services/backup_offsite_service.py@@ -1,4 +1,4 @@-"""Offsite verification hardening (plan 23 Phase 4).+"""Offsite verification hardening.For remote-copy policies, prove the offsite object actually matches — not just"the upload call returned":@@ -67,7 +67,7 @@ class BackupOffsiteService:def _destination_of(run):"""A stable key for the destination a run's offsite copy lives in. Todayevery run shares one configured provider (one group), but the day a- second bucket/provider lands (plan 36) each destination samples on its+ second bucket/provider lands each destination samples on itsown — so a full backup is never left unproven because a differentdestination happened to win the single-sample lottery."""meta = run.get_metadata() or {}@@ -85,8 +85,8 @@ class BackupOffsiteService:@classmethoddef _sample_per_destination(cls, runs, seed):- """One deterministically sampled run per distinct destination (plan 30- #10 / Decision 7). A no-op vs the old one-run-total behaviour while+ """One deterministically sampled run per distinct destination. A no-op+ vs the old one-run-total behaviour whilestorage is single-provider; correct the day a second destination exists."""groups = {}for r in runs:diff --git a/backend/app/services/backup_policy_service.py b/backend/app/services/backup_policy_service.pyindex 887c8cf3..1dbace33 100644--- a/backend/app/services/backup_policy_service.py+++ b/backend/app/services/backup_policy_service.py@@ -215,7 +215,7 @@ class BackupPolicyService:keys: name, root_path, target_type, site (wp only), app, plusdb_config (database) / file_paths (files) for the non-resource targets."""- # Checked first: extension-registered kinds (plan 52 D4 — e.g.+ # Checked first: extension-registered kinds (e.g.# 'wordpress_site' while the WordPress extension is installed) own# their resolution. An unrecognised type must NEVER reach the# application fallthrough at the bottom (it would back up the wrong@@ -262,7 +262,7 @@ class BackupPolicyService:if policy.target_type == 'files':meta = policy.get_target_meta()file_paths = list(meta.get('paths') or [])- # Appliance tier (plan 35): a manifest disk backs a named docker+ # Appliance tier: a manifest disk backs a named docker# volume, so back up its live HOST mountpoint, not the in-container# path. Falls back to `paths` when the volume isn't resolvable yet.vol_mount = meta.get('volume_mount')@@ -276,7 +276,7 @@ class BackupPolicyService:file_paths = [host_path]except Exception:pass- # Unit disks live in a synthetic per-container docker volume (plan 35);+ # Unit disks live in a synthetic per-container docker volume;# resolve its live mountpoint directly by name.docker_volume = meta.get('docker_volume')if docker_volume:@@ -336,7 +336,7 @@ class BackupPolicyService:env['SERVERKIT_TARGET_PATH'] = target['root_path'] or ''try:# shell=True stays: this is an operator-authored hook, and running- # it through a shell is the documented contract (plan 75 anti-goal).+ # it through a shell is the documented contract (anti-goal).result = run_checked(hook, shell=True, cwd=target['root_path'] or None, env=env,timeout=600,@@ -942,7 +942,7 @@ class BackupPolicyService:}# ------------------------------------------------------------------ #- # Restore-proof view (plan 23 Phase 3) — the "last proven restore" badge+ # Restore-proof view — the "last proven restore" badge# ------------------------------------------------------------------ ## A drilled policy reads as "stale" once its last successful drill is olderdiff --git a/backend/app/services/backup_verify_service.py b/backend/app/services/backup_verify_service.pyindex 649e9e49..318a90f2 100644--- a/backend/app/services/backup_verify_service.py+++ b/backend/app/services/backup_verify_service.py@@ -1,4 +1,4 @@-"""Tier-1 backup verification (plan 23 Phase 1).+"""Tier-1 backup verification.Every ``backup.policy.run`` writes a ``manifest.json`` next to its archives andthen runs a cheap, always-on verification pass over the produced archive(s):diff --git a/backend/app/services/bootstrap_service.py b/backend/app/services/bootstrap_service.pyindex 8086e3cf..e98a5641 100644--- a/backend/app/services/bootstrap_service.py+++ b/backend/app/services/bootstrap_service.py@@ -1,4 +1,4 @@-"""One-shot appliance first-boot bootstrap (plan 35).+"""One-shot appliance first-boot bootstrap.Some appliances generate a config/certificate tree exactly once, on first run.Abusing a compose init container leaves it behind; abusing an entrypoint rerunsdiff --git a/backend/app/services/bottleneck_hints_service.py b/backend/app/services/bottleneck_hints_service.pyindex a125c520..9e25b51e 100644--- a/backend/app/services/bottleneck_hints_service.py+++ b/backend/app/services/bottleneck_hints_service.py@@ -1,4 +1,4 @@-"""Name an app's likely bottleneck from what the panel measures (plan 86 §A5).+"""Name an app's likely bottleneck from what the panel measures.A rule-based doctor, no AI: it reads the app's request metrics (§A2), itscontainer's CPU, and, for a PostgreSQL / MySQL it reaches through@@ -13,7 +13,7 @@ Rules (all over the last 24 h):slow + app busy + database idle → page cache (micro-cache) or a bigger boxslow + database busy + one query dominates → a cache, or an index- 5xx inside a deploy window → A/B slot deploys (plan 87)+ 5xx inside a deploy window → A/B slot deploysmicro-cache on, low hit ratio → the pages vary too much, or the TTL is shortNot covered, deliberately: "large static share of bytes" and "slow POST@@ -189,7 +189,7 @@ class BottleneckHintsService:'params': {'errors': errors},'signal': f'{errors} server errors during deploys in the last 24 h','hint': 'Visitors hit the gap while the old container stops and the '- 'new one starts. A/B slot deploys (plan 87) keep the old copy '+ 'new one starts. A/B slot deploys keep the old copy ''serving until the new one passes its health check.','action': None,'failure_mode': 'Two copies run briefly during the switch; a migration 'diff --git a/backend/app/services/bounce_service.py b/backend/app/services/bounce_service.pyindex 9b72cf2d..9740c2b7 100644--- a/backend/app/services/bounce_service.py+++ b/backend/app/services/bounce_service.py@@ -1,4 +1,4 @@-"""Bounce / complaint suppression service (plan 33 Phase 4, roadmap #24).+"""Bounce / complaint suppression service (roadmap #24).Turns an inbound provider webhook (SendGrid / Postmark / SES / Mailgun / ageneric shape) into ``EmailBounceState`` rows. Provider payloads are normalizeddiff --git a/backend/app/services/build_service.py b/backend/app/services/build_service.pyindex 3c621089..ff382973 100644--- a/backend/app/services/build_service.py+++ b/backend/app/services/build_service.py@@ -616,8 +616,7 @@ class BuildService:Auto-detects build method if set to 'auto'. ``image_tag`` names theimage; a deploy passes an immutable per-deployment tag so a rollback- redeploys the image that actually ran, not whatever ``:latest`` is now- (plan 87 §A1).+ redeploys the image that actually ran, not whatever ``:latest`` is now."""build_config = cls.get_app_build_config(app_id)if not build_config:diff --git a/backend/app/services/buildpack_service.py b/backend/app/services/buildpack_service.pyindex 7ca0ce27..74e72ad7 100644--- a/backend/app/services/buildpack_service.py+++ b/backend/app/services/buildpack_service.py@@ -413,7 +413,7 @@ class BuildpackService:@classmethoddef _apply_procfile(cls, repo_path: str, files: set, plan: Dict) -> None:"""A Procfile ``web:`` line overrides the inferred start command; the- other long-running lines become ``plan['processes']`` (plan 86 §C3),+ other long-running lines become ``plan['processes']``,run as sibling containers of the same image at deploy."""if 'Procfile' not in files:return@@ -710,7 +710,7 @@ class BuildpackService:networks: Optional[list] = None) -> str:"""Return a docker-compose snippet wrapping the generated image.- Appliance tier (plan 35): ``extra_ports`` are raw compose publish+ Appliance tier: ``extra_ports`` are raw compose publishstrings (typed L4 ports) appended to the app's own HTTP port;``volumes`` are service mount specs and ``named_volumes`` declare thetop-level named volumes they reference.@@ -740,7 +740,7 @@ class BuildpackService:for net in networks:lines.append(f' - {net}')for process, command in ((plan.get('processes') or {}).items()):- # Same image, the Procfile command, no port (plan 86 §C3).+ # Same image, the Procfile command, no port.lines += [f' {safe_name}-{process}:',f' image: serverkit-{safe_name}:latest',diff --git a/backend/app/services/cache_service.py b/backend/app/services/cache_service.pyindex 74a0a5f3..ef06e706 100644--- a/backend/app/services/cache_service.py+++ b/backend/app/services/cache_service.py@@ -142,7 +142,7 @@ def cached(key_template, ttl=300):def ttl_cached(ttl, key_fn=None):"""Cache a function's return through CacheService for ``ttl`` seconds- (plan 77 F2 — replaces hand-rolled module-level ``{'data':…,'timestamp':…}``+ (replaces hand-rolled module-level ``{'data':…,'timestamp':…}``TTL dicts; Redis benefits apply automatically wherever configured).The cached value must be JSON-serializable (the Redis path serializes).diff --git a/backend/app/services/capacity_service.py b/backend/app/services/capacity_service.pyindex 3b2f6504..09963689 100644--- a/backend/app/services/capacity_service.py+++ b/backend/app/services/capacity_service.py@@ -69,7 +69,7 @@ def parse_size(value):# Re-exported so existing `from app.services.capacity_service import format_size`# callers keep working; the implementation moved to the leaf utils module when-# host_inventory_service turned out to hold a byte-for-byte copy (plan 75 §F1).+# host_inventory_service turned out to hold a byte-for-byte copy.from app.utils.formatting import format_size # noqa: E402,F401@@ -266,7 +266,7 @@ def _local_headroom():# Not hardcoded `/` any more: images, volumes and backups may live on an# attached volume, and measuring root would then answer a question# nobody asked. `mountpoint` records which filesystem this actually is,- # so an unlabelled number can never be misread again (plan 74).+ # so an unlabelled number can never be misread again.mountpoint, disk = host_inventory_service.data_path_usage()result.update({'memory_total': memory.total,diff --git a/backend/app/services/chat_webhook_service.py b/backend/app/services/chat_webhook_service.pyindex 8ecd1202..65d5acaf 100644--- a/backend/app/services/chat_webhook_service.py+++ b/backend/app/services/chat_webhook_service.py@@ -1,4 +1,4 @@-"""Organization-level chat / webhook connections (plan 24 Phase 4).+"""Organization-level chat / webhook connections.The write + delivery half of :class:`app.models.chat_webhook.ChatWebhookConnection`— a shared Discord/Slack/Telegram room or a generic signed webhook that receivesdiff --git a/backend/app/services/cloudflare_ops_bridge.py b/backend/app/services/cloudflare_ops_bridge.pyindex fbf6777c..23025f85 100644--- a/backend/app/services/cloudflare_ops_bridge.py+++ b/backend/app/services/cloudflare_ops_bridge.py@@ -30,7 +30,7 @@ def ensure_loadable():def load(module_name):"""Import a module from the extension backend (e.g. ``'cloudflare_service'``).- Resolution order (plan 52 Ph2 cutover): a copy-installed extension first+ Resolution order (cutover): a copy-installed extension first(the registry install lands under the normal ``app.plugins`` path), thenthe builtin registration (pre-cutover trees), then the historical corelocation. Callers get ImportError when the extension truly is absent —diff --git a/backend/app/services/compose_env_service.py b/backend/app/services/compose_env_service.pyindex e4d85d7f..51dee19c 100644--- a/backend/app/services/compose_env_service.py+++ b/backend/app/services/compose_env_service.py@@ -193,7 +193,7 @@ class ComposeEnvService:if not (isinstance(svc, dict) and svc.get('restart')):services_block.setdefault(name, {})['restart'] = 'unless-stopped'- # Shared service network (plan 86 §C1): an app that offers connection+ # Shared service network: an app that offers connection# properties (Redis, MinIO...) or consumes one through `fromService`# joins SHARED_NETWORK so the two can reach each other by container# name. `default` is listed too — naming any network on a service@@ -204,7 +204,7 @@ class ComposeEnvService:services_block.setdefault(name, {})['networks'] = {'default': {}, SHARED_NETWORK: {}}- # Opt-in PgBouncer beside a PostgreSQL engine (plan 86 §D1): a whole+ # Opt-in PgBouncer beside a PostgreSQL engine: a whole# extra service, reachable from apps over the shared network only.from app.services import pooler_servicepooler = pooler_service.sidecar(app, services)diff --git a/backend/app/services/connect_client.py b/backend/app/services/connect_client.pyindex 7976e273..fa26b260 100644--- a/backend/app/services/connect_client.py+++ b/backend/app/services/connect_client.py@@ -433,7 +433,7 @@ def disconnect(remove_key: bool = False) -> dict:"""Forget the pairing locally. Does NOT revoke anything on ServerKit Cloud."""stop_relay_client() # no-op unless the client runs in this process# The managed profile belongs to the pairing and leaves with it: a panel- # that is no longer connected is not managed (plan 25).+ # that is no longer connected is not managed.from app.services import connect_managed_profileconnect_managed_profile.clear('disconnected')removed = []@@ -814,7 +814,7 @@ class RelayClient:def _clear_managed_profile(self):"""A revoked panel is not managed: lift the profile immediately- (plan 25 "Revoked or unpaired")."""+ ("Revoked or unpaired")."""try:from app.services import connect_managed_profileconnect_managed_profile.clear('revoked', app=self.app)diff --git a/backend/app/services/connect_managed_profile.py b/backend/app/services/connect_managed_profile.pyindex 6ca38ddd..8e43a6f8 100644--- a/backend/app/services/connect_managed_profile.py+++ b/backend/app/services/connect_managed_profile.py@@ -8,7 +8,7 @@ This module is the only writer of ``managed-profile.json`` — kept next to``connect.json`` because it belongs to the pairing and leaves with it — andthe only place that decides whether the profile currently applies.-The rules that keep this truthful (plan 25):+The rules that keep this truthful:- **Hidden, never removed.** The policy changes what the panel *shows*. Everyroute stays registered and every API keeps answering with the caller's@@ -38,7 +38,7 @@ logger = logging.getLogger(__name__)PROFILE_FILENAME = 'managed-profile.json'-# The launch capability set (plan 25 §Vocabulary). Cloud validates against its+# The launch capability set. Cloud validates against its# own copy before signing; the panel stores what it received and the UI maps# the ids it knows, so an id from a newer Cloud simply maps to nothing here.CAPABILITIES = (diff --git a/backend/app/services/connect_tunnel.py b/backend/app/services/connect_tunnel.pyindex 6c075d59..5df44af0 100644--- a/backend/app/services/connect_tunnel.py+++ b/backend/app/services/connect_tunnel.py@@ -1,4 +1,4 @@-"""The browser tunnel, panel side (ServerKit Cloud plan 01 M3).+"""The browser tunnel, panel side.When somebody presses "Open panel" in ServerKit Cloud, their browser talksto the relay, and the relay opens streams down this panel's connection:diff --git a/backend/app/services/container_status_service.py b/backend/app/services/container_status_service.pyindex 261618c1..b89baaac 100644--- a/backend/app/services/container_status_service.py+++ b/backend/app/services/container_status_service.py@@ -363,7 +363,7 @@ class _ContainerIndex:"""Containers belonging to ``app``, in the trust order documented above."""slot_project = _live_slot_project(app)if slot_project:- # A compose app on A/B slots (plan 87): only the live slot's+ # A compose app on A/B slots: only the live slot's# project counts. The standby is not rolled into the status, so a# stopped standby never reads as a degraded app.return self.by_project.get(slot_project, [])diff --git a/backend/app/services/contribution_service.py b/backend/app/services/contribution_service.pyindex d60bd3af..1a4d4e32 100644--- a/backend/app/services/contribution_service.py+++ b/backend/app/services/contribution_service.py@@ -155,8 +155,8 @@ def get_active_contributions():'tabs': tabs,'walkthroughs': walkthroughs,'ai': ai,- # Panel SDK version the client uses to gate runtime bundles (plan 25 #1).+ # Panel SDK version the client uses to gate runtime bundles.'sdk_version': SDK_VERSION,- # Runtime-loadable ESM frontends (plan 25 Phase 2, core-slim #39).+ # Runtime-loadable ESM frontends (core-slim #39).'frontends': _runtime_frontends(plugins),}diff --git a/backend/app/services/crash_loop_service.py b/backend/app/services/crash_loop_service.pyindex fc7c2c88..8f64fc9e 100644--- a/backend/app/services/crash_loop_service.py+++ b/backend/app/services/crash_loop_service.py@@ -1,4 +1,4 @@-"""Crash-loop visibility (plan 86 §E1).+"""Crash-loop visibility.A container with a restart policy that keeps dying looked "running" in thepanel: Docker restarts it each time, and nothing counted. A one-minute@@ -89,7 +89,7 @@ class CrashLoopService:if new_state != state:SystemSettings.set(STATE_KEY, new_state, value_type='json',- description='Crash-loop sample windows (plan 86 §E1)')+ description='Crash-loop sample windows')db.session.commit()return {'apps': len(new_state), 'opened': opened, 'resolved': resolved}diff --git a/backend/app/services/cron_service.py b/backend/app/services/cron_service.pyindex b04208d3..39b58ed1 100644--- a/backend/app/services/cron_service.py+++ b/backend/app/services/cron_service.py@@ -112,7 +112,7 @@ class CronService:"""Check if running on Linux."""return platform.system() == 'Linux'- # ── the crontab door (plan 75 §G1) ────────────────────────────────────+ # ── the crontab door ────────────────────────────────────# `crontab -l` followed by a Popen-with-stdin `crontab -` was written out# five times in this file, each with its own capture_output/text/timeout# boilerplate and its own error wording. Two helpers, one run_checked.@@ -244,7 +244,7 @@ class CronService:})# Enrich exactly like jobs_for_application(): a human schedule, the next- # fire time, and the last-run join (plan 34). The admin list page renders+ # fire time, and the last-run join. The admin list page renders# Last run / Next run / Status columns off these, so both surfaces have# to agree — leaving it out here is what left /cron showing enabled-only.for job in jobs:@@ -410,7 +410,7 @@ class CronService:`application_id` optionally attributes the job to an application so themember-facing /cron/jobs/for-app surface can show it. Scope(workspace/project) is never stored here — it is derived from the app at- read time (plan 19 Decision 3)."""+ read time."""# Validate schedule formatif not cls._validate_schedule(schedule):return {'success': False, 'error': 'Invalid cron schedule format'}@@ -942,7 +942,7 @@ class CronService:@classmethoddef jobs_for_application(cls, application_id) -> List[Dict]:"""All jobs attributed to `application_id`, enriched with a human- schedule, the next run time, and a read-time last-run join (plan 34)."""+ schedule, the next run time, and a read-time last-run join."""metadata = cls._load_jobs_metadata()jobs = []for job_id, job_data in metadata.get('jobs', {}).items():diff --git a/backend/app/services/dashboard_service.py b/backend/app/services/dashboard_service.pyindex 6bb95423..0844ed12 100644--- a/backend/app/services/dashboard_service.py+++ b/backend/app/services/dashboard_service.py@@ -1,4 +1,4 @@-"""Dashboard board service (plan 62).+"""Dashboard board service.Owns the shipped default boards and the per-user CRUD around them. A board is adashboard tab; a widget instance is ``{i, type, x, y, w, h, cfg}`` placed on adiff --git a/backend/app/services/database_service.py b/backend/app/services/database_service.pyindex 4e5e4091..e436201d 100644--- a/backend/app/services/database_service.py+++ b/backend/app/services/database_service.py@@ -33,7 +33,7 @@ class DatabaseService:"""Check if MySQL/MariaDB is installed."""# run_checked also resolves argv[0] when $PATH misses it, so a client# installed outside the unit's PATH stops reading as "not installed"- # (plan 74's outage class).+ # (the class behind a past outage).return run_checked(['mysql', '--version'], timeout=None)['success']@staticmethod@@ -45,7 +45,7 @@ class DatabaseService:def _mysql_env(root_password):"""Process env with ``MYSQL_PWD`` set, or ``None`` when there is no password.- Pasted verbatim eight times in this file (plan 75 §G5). It carries a+ Pasted verbatim eight times in this file. It carries areal rule — the password goes in the environment, never on the argv,where ``ps`` and the shell history would see it — and a rule that livesin eight copies is a rule that only holds in the copies someone@@ -1148,8 +1148,7 @@ class DatabaseService:no box drawing. Callers that parse the output need it; callers thatshow the output to a human do not. It is a flag rather than a secondmethod because ``db_config_tuner_service`` used to keep a private copy- of this whole function purely to add those two characters- (plan 75 §G5).+ of this whole function purely to add those two characters."""try:cmd = ['docker', 'exec']diff --git a/backend/app/services/db_config_tuner_service.py b/backend/app/services/db_config_tuner_service.pyindex da89a5b4..d0e2b4d1 100644--- a/backend/app/services/db_config_tuner_service.py+++ b/backend/app/services/db_config_tuner_service.py@@ -504,8 +504,8 @@ class DbConfigTunerService:@classmethoddef enable_pg_stat_statements(cls, target):- """Preload pg_stat_statements, restart, and create the extension- (plan 86 §A3), through the same backup/restart/verify path as+ """Preload pg_stat_statements, restart, and create the extension,+through the same backup/restart/verify path as:meth:`apply`, so :meth:`rollback` undoes it.``shared_preload_libraries`` is a list: the current value is kept anddiff --git a/backend/app/services/db_exec.py b/backend/app/services/db_exec.pyindex c6ee4f4a..261902e3 100644--- a/backend/app/services/db_exec.py+++ b/backend/app/services/db_exec.py@@ -1,4 +1,4 @@-"""One SQL-exec dispatcher (plan 75 §G5).+"""One SQL-exec dispatcher.`engine × host` dispatch — mysql/postgres crossed with native/docker — waswritten three times: `db_config_tuner_service`, `db_process_service`, anddiff --git a/backend/app/services/db_insights_service.py b/backend/app/services/db_insights_service.pyindex 1cf54131..60f80825 100644--- a/backend/app/services/db_insights_service.py+++ b/backend/app/services/db_insights_service.py@@ -1,4 +1,4 @@-"""Read-only database visibility: top queries and health gauges (plan 86 §A3).+"""Read-only database visibility: top queries and health gauges.For the Database Explorer's Insights tab, per server or container, with thesame target shape as :mod:`db_process_service`:diff --git a/backend/app/services/demo_deploy_service.py b/backend/app/services/demo_deploy_service.pyindex 231142cc..412d6177 100644--- a/backend/app/services/demo_deploy_service.py+++ b/backend/app/services/demo_deploy_service.py@@ -1,6 +1,6 @@"""Simulated deployments — scripted DeploymentJobs for the Deploy Console.-Plan 51.5: lets a developer exercise the full console (StepRail, live log+Lets a developer exercise the full console (StepRail, live logstream, ErrorCard + hints, SuccessBanner, retry) on any dev machine with noDocker, shell, or network access. The "runner" is a script that drives theREAL ``RunLogStream``, so DB rows, socket batches, poll fallback, failurediff --git a/backend/app/services/deploy_lock.py b/backend/app/services/deploy_lock.pyindex 2eb52db2..397ece1f 100644--- a/backend/app/services/deploy_lock.py+++ b/backend/app/services/deploy_lock.py@@ -1,4 +1,4 @@-"""Per-app deploy lock (plan 87 §A5).+"""Per-app deploy lock.Two webhook pushes a second apart used to run two deploys of the same app atonce: both stopped the container, both started one, and whichever lost thediff --git a/backend/app/services/deploy_preflight_service.py b/backend/app/services/deploy_preflight_service.pyindex d0c6f119..a1cad2b7 100644--- a/backend/app/services/deploy_preflight_service.py+++ b/backend/app/services/deploy_preflight_service.py@@ -1,6 +1,6 @@"""Deploy preflight — prove a deploy can work BEFORE anything live is stopped.-Plan 72 B.1. Every redeploy path used to reach its point of no return (a+Every redeploy path used to reach its point of no return (a``compose down`` / ``docker stop``) *before* anything had validated the newconfiguration. An invalid compose file, an image that no longer pulls, or aport somebody else took took the live site down and left it down: nginx 502s@@ -53,7 +53,7 @@ KIND_BUILD_FAILED = 'build_failed'KIND_PORT_CONFLICT = 'port_conflict'KIND_DISK_LOW = 'disk_low'-# Free space a pull/build needs (plan 85 D4). Under the floor the deploy is+# Free space a pull/build needs. Under the floor the deploy is# refused — images cannot fit and a full disk also stops the panel's database# writing. Under the warning line it proceeds with a warning.DISK_BLOCK_BYTES = 512 * 1024 ** 2diff --git a/backend/app/services/deploy_settings.py b/backend/app/services/deploy_settings.pyindex a700ae66..afc1ea92 100644--- a/backend/app/services/deploy_settings.py+++ b/backend/app/services/deploy_settings.py@@ -1,4 +1,4 @@-"""Per-app deploy settings (plan 87).+"""Per-app deploy settings.Stored as one JSON object on ``Application.deploy_settings``; NULL or amissing key means the default below. ``effective(app)`` is what every readerdiff --git a/backend/app/services/deploy_stages.py b/backend/app/services/deploy_stages.pyindex 90fde6da..3ed64dbe 100644--- a/backend/app/services/deploy_stages.py+++ b/backend/app/services/deploy_stages.py@@ -1,4 +1,4 @@-"""Deploy Console stage markers (plan 87 §F).+"""Deploy Console stage markers.The Deploy Console's PipelineStrip renders ``job.plan.steps``; the job runneradvances it with ``set_step``. A deploy passes through several servicesdiff --git a/backend/app/services/deployment_runner.py b/backend/app/services/deployment_runner.pyindex 0d275447..04d7c9a8 100644--- a/backend/app/services/deployment_runner.py+++ b/backend/app/services/deployment_runner.py@@ -30,7 +30,7 @@ class DeploymentPlanRunner:if not job.correlation_id:job.correlation_id = self.correlation_id# All log/step/close writes funnel through the one batched, crash-proof- # seam (plan 51 D4). runner.log() stays a thin wrapper for call-site+ # seam. runner.log() stays a thin wrapper for call-site# compatibility with the 98ad048 code.self.stream = RunLogStream.for_job(job)@@ -232,8 +232,8 @@ class DeploymentPlanRunner:if not project_dir:raise DeploymentStepError('docker.compose.up step requires project_dir for local targets')# Stream the real pull/build/start transcript into the run log so the- # Deploy Console shows it live and a failure persists a meaningful tail- # (plan 51 D5). The line callback rides the batched stream.+ # Deploy Console shows it live and a failure persists a meaningful tail.+ # The line callback rides the batched stream.current_step = self.job.current_stepresult = DockerService.compose_up_streaming(project_dir,diff --git a/backend/app/services/deployment_service.py b/backend/app/services/deployment_service.pyindex 325b2e8d..c40b40da 100644--- a/backend/app/services/deployment_service.py+++ b/backend/app/services/deployment_service.py@@ -95,7 +95,7 @@ class DeploymentService:This is the main entry point for deployments. It holds the app's deploylock for the whole run, so a second deploy of the same app waits for- this one instead of racing it (plan 87 §A5).+ this one instead of racing it."""from app.services.deploy_lock import deploy_lock, DeployLockTimeouttry:@@ -242,8 +242,8 @@ class DeploymentService:keep_count = build_config.get('keep_deployments', 5)Deployment.cleanup_old_deployments(app_id, keep_count)- # One image per deploy is a disk leak unless something prunes it- # (plan 85). Keeps the newest few for rollback.+ # One image per deploy is a disk leak unless something prunes it.+ # Keeps the newest few for rollback.if app.app_type == 'docker' and not app.server_id:from app.services import app_image_retention, deploy_settingsapp_image_retention.prune(app_id, keep=deploy_settings.get(app, 'keep_images'),@@ -254,7 +254,7 @@ class DeploymentService:# app.deployed was in the event catalog but nothing emitted it.# Webhook subscribers and in-process listeners (a CDN purge,- # plan 86 §B4) hear it now. Best-effort: never fails the deploy.+ # hear it now. Best-effort: never fails the deploy.try:from app.services.event_service import EventServiceEventService.emit('app.deployed', {@@ -352,7 +352,7 @@ class DeploymentService:from app.services.slot_deploy_service import SlotDeployService, SlotDeployErrorif app.slot_deploys_enabled:- # A/B slots (plan 87 §C): the project boots as <name>-<idle slot>+ # A/B slots: the project boots as <name>-<idle slot># beside the live one instead of recreating it in place.verdict = SlotDeployService.eligibility(app)if not verdict['eligible']:@@ -417,7 +417,7 @@ class DeploymentService:from app.services.env_service import EnvServiceenv = EnvService.get_effective_env(app.id)- # ---- preflight (plan 72 B.1) -------------------------------------+ # ---- preflight -------------------------------------------------# Everything that can fail while the old container keeps serving runs# HERE, above the stop. The image is the only pre-traffic requirement# this path has: a build already ran to completion in deploy() step 1,@@ -451,7 +451,7 @@ class DeploymentService:from app.services.slot_deploy_service import SlotDeployServiceif app.slot_deploys_enabled:- # A/B slots (plan 87 §B): boot beside the live release, gate,+ # A/B slots: boot beside the live release, gate,# switch, watch. Eligibility is re-checked on every deploy; an app# that stopped qualifying fails here rather than silently taking# the downtime of an in-place deploy.@@ -504,8 +504,8 @@ class DeploymentService:if app.live_domains:SiteDomainService.write_app_vhost(app)SlotDeployService._reapply_vhost_extras(app)- # Procfile worker/scheduler lines run as siblings of the same image- # (plan 86 §C3). Best-effort: the web process is already live.+ # Procfile worker/scheduler lines run as siblings of the same image.+ # Best-effort: the web process is already live.workers = WorkerProcessService.deploy(app, image_tag, env, volumes, log=log_callback)if workers['failed'] and log_callback:diff --git a/backend/app/services/disk_alert_service.py b/backend/app/services/disk_alert_service.pyindex 3ecdf7ad..799115f0 100644--- a/backend/app/services/disk_alert_service.py+++ b/backend/app/services/disk_alert_service.py@@ -1,4 +1,4 @@-"""Warn before the panel host's disk fills (plan 85 §D3).+"""Warn before the panel host's disk fills.Host disk alerts existed but were off by default and not started at boot,and Doctor's ``disk.headroom`` failure notified nobody — so a box reacheddiff --git a/backend/app/services/dns_cutover_service.py b/backend/app/services/dns_cutover_service.pyindex 133fc5ac..77cb0b08 100644--- a/backend/app/services/dns_cutover_service.py+++ b/backend/app/services/dns_cutover_service.py@@ -7,14 +7,13 @@ it cannot power a revert on its own. This service therefore:* **snapshots** the domain's existing provider records (server-sourced — thepanel reads them itself; the client may only filter which *names* to include,- never supply record data — plan 31 #2);+ never supply record data);* performs the **cutover** (with a dry-run that returns the exact provider ops- without writing — plan 31 #1), tracking the records it *creates* so the revert+ without writing), tracking the records it *creates* so the revertcan undo them;-* **verifies** post-cutover resolution across public resolvers (plan 31 #1);+* **verifies** post-cutover resolution across public resolvers;* **reverts** by DELETING the records the cutover created (reverse order) and- re-applying every captured record, restoring the world byte-for-byte- (plan 31 #3, Decision 3).+ re-applying every captured record, restoring the world byte-for-byte.The provider client is resolved through the registered ``DNSProviderConfig``providers (Decision 4); providers without a shared client stay a clean 501@@ -295,14 +294,14 @@ class DnsCutoverService:'domain': snapshot.domain, 'target': target, 'ops': ops,'results': results, 'snapshot': snapshot.to_dict()}- # ── verify (plan 31 #1) ──────────────────────────────────────────────────+ # ── verify ──────────────────────────────────────────────────@classmethoddef verify(cls, domain, record_type='A', expected=None, snapshot_id=None):"""Check post-cutover resolution across public resolvers.Thin wrapper over the multi-resolver propagation check. When``expected`` (the address the cutover pointed at) is given, annotate the- result with whether every resolver already returns it (plan 31 #1).+ result with whether every resolver already returns it."""from app.services.dns_zone_service import DNSZoneService@@ -337,7 +336,7 @@ class DnsCutoverService:so a create-only cutover reverts to *empty*, not to a stale target. Thenre-apply every captured record with ``allow_foreign=True`` (the recordnow points at the new box — our own cutover write — and we deliberately- restore the operator's original value). (plan 31 #3, Decision 3.)+ restore the operator's original value)."""from app.services.dns import DnsRecordSpecdiff --git a/backend/app/services/docker_service.py b/backend/app/services/docker_service.pyindex a8de8ac2..3e1f687a 100644--- a/backend/app/services/docker_service.py+++ b/backend/app/services/docker_service.py@@ -378,7 +378,7 @@ class DockerService:# The panel emits the `app.stopped` event via the audit trail# (AuditService.log('app.stop') -> EventService.emit_for_audit),# so this low-level helper no longer emits its own event -- doing- # so would double-fire it for Automations triggers (plan 45 Ph4).+ # so would double-fire it for Automations triggers.return {'success': True}return {'success': False, 'error': result['error']}except Exception as e:@@ -526,7 +526,7 @@ class DockerService:app_id = cls._app_attr(app, 'id')if (app_id and not isinstance(app, dict)and cls._app_attr(app, 'slot_deploys_enabled') and cls._app_attr(app, 'active_slot')):- # A slot app (plan 87): the live slot, its standby, its workers+ # A slot app: the live slot, its standby, its workers# (for compose, the live and standby projects).from app.services.slot_deploy_service import SlotDeployServicereturn SlotDeployService.containers(app)@@ -534,7 +534,7 @@ class DockerService:if not containers and app_id and cls._app_attr(app, 'buildpack_type'):# A build-pack app is not a compose project: its deploy runs# `serverkit-app-<id>` plus one `serverkit-app-<id>-<process>` per- # Procfile worker (plan 86 §C3). Anchored so app 5 never lists 50.+ # Procfile worker. Anchored so app 5 never lists 50.listed = cls.run(['ps', '-a', '--filter', f'name=^serverkit-app-{app_id}$','--filter', f'name=^serverkit-app-{app_id}-','--format', '{{json .}}'], timeout=30)@@ -911,7 +911,7 @@ class DockerService:@staticmethoddef ensure_network(name, driver='bridge'):- """Idempotently ensure a Docker network exists (appliance tier, plan 35).+ """Idempotently ensure a Docker network exists (appliance tier).The shared external ``serverkit`` network lets manifest-generated appprojects resolve each other by container name (fromService.host)."""@@ -1180,7 +1180,7 @@ class DockerService:"""Start Docker Compose services, streaming each output line to on_line.Same overlay/command construction as ``compose_up``, but runs via Popen- with plain, ANSI-free progress (plan 51 D5) and delivers output+ with plain, ANSI-free progress and delivers outputline-by-line so the Deploy Console shows the real pull/build/starttranscript live (the biggest reason template-install errors used to beunreadable). Returns ``{success, exit_code}``; the actual failure output@@ -1341,7 +1341,7 @@ class DockerService:def compose_build(cls, project_path, service=None, compose_file=None, no_cache=False):"""Build the project's images without starting anything.- The deploy preflight (plan 72 B.1) runs this *before* the live+ The deploy preflight runs this *before* the livecontainers are stopped, so a build failure can no longer take a sitedown: the subsequent ``up --build`` re-uses the layer cache."""@@ -1446,7 +1446,7 @@ class DockerService:``cpu_limit`` / ``memory_limit`` (task #23) emit ``cpus`` / ``mem_limit``on the app's service block so Docker enforces the caps.- ``host_requirements`` (appliance tier, plan 35) emits+ ``host_requirements`` (appliance tier) emits``privileged`` / ``cap_add`` / ``sysctls`` / ``devices`` — exactly thefields catalog templates already pass through."""@@ -1499,7 +1499,7 @@ class DockerService:if networks:# Attach to shared external network(s) so manifest apps resolve- # each other by container name (fromService.host, plan 35).+ # each other by container name (fromService.host).for net in networks:DockerService.ensure_network(net)compose['services'][app_name]['networks'] = list(networks)diff --git a/backend/app/services/doctor_service.py b/backend/app/services/doctor_service.pyindex 64cffbc9..a34ccba6 100644--- a/backend/app/services/doctor_service.py+++ b/backend/app/services/doctor_service.py@@ -361,7 +361,7 @@ class DoctorService:return _check('db.reachable', 'Database', 'fail', f'Query failed: {e}')# ------------------------------------------------------------------ #- # Site-DNS sweep (plan 26/31): do the managed site domains still resolve,+ # Site-DNS sweep: do the managed site domains still resolve,# and do they point at this server? Each unresolved public domain becomes a# fail row, repairable via a connected DNS provider when one is set up.# ------------------------------------------------------------------ #@@ -555,7 +555,7 @@ class DoctorService:logger.warning('could not send dns.unresolved notification: %s', e)# ------------------------------------------------------------------ #- # Backup restore-proof (plan 23 Phase 3): is each policy's latest backup+ # Backup restore-proof: is each policy's latest backup# actually restorable? Two check families per policy:# backup_drill_stale.<id> — cadence'd policies whose last drill is stale /# failed / never (skipped when cadence is 'off').diff --git a/backend/app/services/drift_service.py b/backend/app/services/drift_service.pyindex 3f80abf2..fdfdea8a 100644--- a/backend/app/services/drift_service.py+++ b/backend/app/services/drift_service.py@@ -370,7 +370,7 @@ def _nginx_render_expected(app_id):# (WafService.apply). Render the expected file through the SAME injector,# or every WAF'd app reads as permanently drifted and one "repair" click# regenerates the vhost without the include — silently unprotecting the- # site while the DB still says enforcing (plan 82 §F.1).+ # site while the DB still says enforcing.config = _with_expected_waf(app.id, config)path = os.path.join(NginxService.SITES_AVAILABLE, app.name)@@ -389,18 +389,23 @@ def _with_expected_waf(app_id, config):return injected if injected is not None else config-# A vhost written before the timed log format (plan 86 §A1) has a bare+# A vhost written before the timed log format has a bare# `access_log <path>;`. That is not drift: the format only changes what the log# records, and the next regeneration adopts it. Read such lines as the timed# form so an upgrade doesn't flag (and notify about) every existing site._LEGACY_ACCESS_LOG_RE = re.compile(r'^(\s*access_log /var/log/nginx/[^\s;]+\.access\.log);$', re.MULTILINE)+# Older vhosts carry an internal reference after this comment; the comment is+# all that changed, so it is not drift either.+_LEGACY_ASSET_COMMENT_RE = re.compile(+ r'^(\s*# ServerKit: fingerprinted assets never change) \([^)\n]*\)$', re.MULTILINE)def _nginx_read_actual(paths):actual = _default_read_actual(paths)return {- path: (_LEGACY_ACCESS_LOG_RE.sub(r'\1 serverkit_timed;', content)+ path: (_LEGACY_ASSET_COMMENT_RE.sub(+ r'\1', _LEGACY_ACCESS_LOG_RE.sub(r'\1 serverkit_timed;', content))if content is not None else None)for path, content in actual.items()}@@ -420,7 +425,7 @@ def _nginx_repair(app_id):# write_app_vhost regenerates from the template, which drops the WAF# include; re-wire it for apps with an enforcing policy so a repair- # never strips protection the DB still records (plan 82 §F.1).+ # never strips protection the DB still records.from app.services.waf_service import WafServiceWafService.reapply_if_enforcing(app_id)diff --git a/backend/app/services/env_reference_service.py b/backend/app/services/env_reference_service.pyindex 06e8abcd..952e261d 100644--- a/backend/app/services/env_reference_service.py+++ b/backend/app/services/env_reference_service.py@@ -1,4 +1,4 @@-"""Resolve manifest env references at injection time (plan 17, Phase 3).+"""Resolve manifest env references at injection time.`fromSecret` -> a vault secret's value; `fromService` -> a sibling service'sconnection property. The resolved value never lands in the env-var row — it is@@ -32,7 +32,7 @@ class EnvReferenceResolver:return cls._resolve_server(app, ref.get('property'))return None, f'unknown reference kind: {kind}'- # -- fromServer (appliance tier, plan 35) -------------------------------+ # -- fromServer (appliance tier) -------------------------------@classmethoddef _resolve_server(cls, app, prop: Optional[str]) -> Tuple[Optional[str], Optional[str]]:@@ -111,7 +111,7 @@ class EnvReferenceResolver:if sibling is not None:# An installed engine / connection-declaring template offers real# connection properties (redis:// url, S3 endpoint...) reachable- # over the shared network (plan 86 §C1); a plain app keeps the+ # over the shared network; a plain app keeps the# generic host/port/url.from app.services.service_connection_service import ServiceConnectionServiceif ServiceConnectionService.is_connectable(sibling):diff --git a/backend/app/services/environment_domain_service.py b/backend/app/services/environment_domain_service.pyindex 6d6be24f..5a6e036b 100644--- a/backend/app/services/environment_domain_service.py+++ b/backend/app/services/environment_domain_service.py@@ -18,7 +18,7 @@ from app.utils.system import run_checked, run_privileged, write_privileged_fileclass EnvironmentDomainService:"""Service for managing per-environment domains and Nginx configs."""- # Not redeclared: NginxService owns where vhosts live (plan 75 §G4). Four+ # Not redeclared: NginxService owns where vhosts live. Four# files used to hardcode these, so a test that redirected NginxService's# paths left the other three writing to the real /etc/nginx.SITES_AVAILABLE = NginxService.SITES_AVAILABLE@@ -136,8 +136,8 @@ class EnvironmentDomainService:)# write + enable + nginx -t + rollback + reload, all owned by- # NginxService (plan 75 §G4). This block used to re-implement it- # with hardcoded `sudo`, which is the founding bug class of plan 75:+ # NginxService. This block used to re-implement it+ # with hardcoded `sudo`, which is the founding bug class of the shared door:# it breaks on a panel running as root without sudo, and never# rolled back a vhost that failed the config test.result = NginxService.write_vhost(site_name, config)@@ -296,7 +296,7 @@ class EnvironmentDomainService:@classmethoddef _reload_nginx(cls) -> Dict:- """Test and reload Nginx — NginxService owns both (plan 75 §G4).+ """Test and reload Nginx — NginxService owns both.Kept as a thin alias so callers outside this module keep working; theprivate re-implementation it replaced hardcoded ``sudo`` and calleddiff --git a/backend/app/services/environment_health_service.py b/backend/app/services/environment_health_service.pyindex b57616b9..5c60be24 100644--- a/backend/app/services/environment_health_service.py+++ b/backend/app/services/environment_health_service.py@@ -102,8 +102,7 @@ class EnvironmentHealthService:db.session.commit()# Emit a panel event on every failing poll so Automations (tramo)- # workflows can trigger on it through the events bridge (plan 45 Ph4,- # ported from the retired Workflow Builder's 'health_check_failed').+ # workflows can trigger on it through the events bridge (# ported from the retired Workflow Builder's 'health_check_failed').if overall in ('unhealthy', 'degraded'):try:from app.services.event_service import EventServicediff --git a/backend/app/services/environment_pipeline_service.py b/backend/app/services/environment_pipeline_service.pyindex d94de957..8fddf569 100644--- a/backend/app/services/environment_pipeline_service.py+++ b/backend/app/services/environment_pipeline_service.py@@ -1716,7 +1716,7 @@ class EnvironmentPipelineService:# Set permissions# run_privileged, not a hardcoded sudo: this is escalation, and- # _needs_sudo() is the one place that decides it (plan 75 §G2).+ # _needs_sudo() is the one place that decides it.run_privileged(['chown', '-R', 'www-data:www-data', target_dir],timeout=60)diff --git a/backend/app/services/event_service.py b/backend/app/services/event_service.pyindex dcc8dc96..7c526bc8 100644--- a/backend/app/services/event_service.py+++ b/backend/app/services/event_service.py@@ -49,7 +49,7 @@ EVENT_CATALOG = [{'type': 'domain.deleted', 'category': 'Domains', 'description': 'A domain was deleted'},{'type': 'api_key.created', 'category': 'API', 'description': 'An API key was created'},{'type': 'api_key.revoked', 'category': 'API', 'description': 'An API key was revoked'},- # Ported from the retired Workflow Builder event bus (plan 45 Phase 4) so+ # Ported from the retired Workflow Builder event bus so# Automations (tramo) workflows can trigger on them via the events bridge.{'type': 'health.check_failed', 'category': 'Monitoring', 'description': 'An environment health check failed'},{'type': 'git.push', 'category': 'Deployments', 'description': 'A git push was received for an app'},@@ -57,7 +57,7 @@ EVENT_CATALOG = [{'type': 'monitor.high_memory', 'category': 'Monitoring', 'description': 'A server crossed its high-memory alert threshold'},]-# Extension-registered event types (plan 52 D4 hook inversion). Extensions add+# Extension-registered event types (hook inversion). Extensions add# their own catalog entries at load via register_event_types() — e.g. the# WordPress extension contributes the wordpress.* lifecycle events. The core# catalog above keeps only core events; an absent extension's types simply@@ -112,7 +112,7 @@ def unregister_event_types(source):return len(doomed)-# In-process listeners (plan 86 §B4): the extension-to-core event path. An+# In-process listeners: the extension-to-core event path. An# extension's core_hooks registers a callable for an event type; every emit of# that type calls it with the payload, best-effort, whether or not any webhook# subscription exists. event type -> [(fn, source slug)].diff --git a/backend/app/services/extension_lifecycle.py b/backend/app/services/extension_lifecycle.pyindex 2af64b1a..c9230e07 100644--- a/backend/app/services/extension_lifecycle.py+++ b/backend/app/services/extension_lifecycle.py@@ -168,7 +168,7 @@ def remove_jobs(plugin, manifest):# --------------------------------------------------------------------------- #-# Core hooks (plan 52 D4 — hook inversion)+# Core hooks (hook inversion)# --------------------------------------------------------------------------- #def register_capabilities(plugin, manifest):diff --git a/backend/app/services/extension_migration.py b/backend/app/services/extension_migration.pyindex 0bd9c017..f58770a0 100644--- a/backend/app/services/extension_migration.py+++ b/backend/app/services/extension_migration.py@@ -36,7 +36,7 @@ CONVERTED_BUILTIN_SLUGS = []# Extensions deliberately deleted from the product (replaced or retired) — the-# Workflow Builder was superseded by serverkit-tramo (plan 45). Their leftover+# Workflow Builder was superseded by serverkit-tramo. Their leftover# copy-installed files must be swept from the live tree: update.sh's plugin# carry-forward would otherwise preserve them into every fresh deploy, where# their dead imports (workflows → reactflow) sink the bundle build. The updater@@ -79,7 +79,7 @@ def remove_retired_extensions():def _gitea_was_used():"""True if this panel actually runs the self-hosted Gitea the gitextension manages — the panel-managed application row exists. Gates- serverkit-git auto-install after its backend split (plan 52 Phase 6) so+ serverkit-git auto-install after its backend split soonly Gitea operators get the extension back automatically; deploys fromexternal remotes never depended on it."""try:@@ -106,7 +106,7 @@ def _email_was_configured():# Builtins auto-installed on upgrade ONLY when a usage predicate says the panel# actually used the feature (D3/#34). Fresh installs and panels that never used# the feature just see it in the Marketplace.-# Empty since the plan 52 Ph2 cutover — every gated slug rides the registry+# Empty since the registry cutover — every gated slug rides the registry# now. The dict (and its predicate wiring) stays: the next core->builtin# conversion drops straight in.GATED_BUILTIN_SLUGS = {}@@ -132,7 +132,7 @@ def _scanners_dir_populated():return False-# Security-suite extractions (plan 47 Ph3b-4 / plan 55 Phase 3). These left+# Security-suite extractions. These left# core for REGISTRY extensions — there is no builtin folder to copy, so# upgrade parity means: when the host tool the old core surface managed is# actually present, install the extension from the registry once. Fail-soft:@@ -140,8 +140,8 @@ def _scanners_dir_populated():# unmarked so the next boot retries; panels without the host tool just see# the extension in the Marketplace.REGISTRY_GATED_SLUGS = {- # serverkit-email / serverkit-git left the tree (plan 52 Ph2/Ph6- # cutover): their gated auto-installs ride the registry now, same+ # serverkit-email / serverkit-git left the tree: their gated+ # auto-installs ride the registry now, same# predicates as before.'serverkit-email': _email_was_configured,'serverkit-git': _gitea_was_used,@@ -153,8 +153,8 @@ REGISTRY_GATED_SLUGS = {}_MARKER_KEY = 'extensions.auto_installed_slugs'-# Slugs whose now-extracted backend has been re-acquired on an upgraded panel-# (plan 47 Phase 2). Separate from _MARKER_KEY so the one-shot backend pickup+# Slugs whose now-extracted backend has been re-acquired on an upgraded panel.+# Separate from _MARKER_KEY so the one-shot backend pickup# runs even for slugs already auto-installed frontend-only in a prior release._BACKEND_ACQUIRED_KEY = 'extensions.backend_acquired_slugs'@@ -331,10 +331,10 @@ def _backend_acquired_slugs():def run_backend_acquisition():- """Re-acquire the backend for converted builtins that gained one (plan 47).+ """Re-acquire the backend for converted builtins that gained one.Some builtins (ftp, cloud-provision, remote-access, status) first shipped as- *frontend-only* extensions whose API was still served by CORE. Plan 47 moves+ *frontend-only* extensions whose API was still served by CORE. The lean-core split movesthat backend into the extension and deregisters it from core. On an upgradedpanel that already installed such an extension frontend-only, the installedrow has ``has_backend=False`` and no backend on disk — so without this pass@@ -355,7 +355,7 @@ def run_backend_acquisition():changed = False# Gated slugs join the sweep: acquisition only ever fires for a slug the# panel already INSTALLED whose builtin now ships a backend it lacks on- # disk (serverkit-git gained one in the plan 52 Phase 6 split), so the+ # disk (serverkit-git gained one in its split), so the# usage gate has already been answered by the install itself.for slug in list(CONVERTED_BUILTIN_SLUGS) + list(GATED_BUILTIN_SLUGS):if slug in done:@@ -379,7 +379,7 @@ def run_backend_acquisition():plugin_service.install_from_path(entry['path'], user_id=row.installed_by, force=True,source_type='builtin')- logger.info(f'Acquired extracted backend for {slug} (plan 47)')+ logger.info(f'Acquired extracted backend for {slug}')done.add(slug)changed = Trueexcept Exception as e:diff --git a/backend/app/services/fail2ban_jail_service.py b/backend/app/services/fail2ban_jail_service.pyindex 5919ee59..3f7c3100 100644--- a/backend/app/services/fail2ban_jail_service.py+++ b/backend/app/services/fail2ban_jail_service.py@@ -146,7 +146,7 @@ bantime = {bantime}@staticmethoddef _write_file(path, content):- """Write *content* to *path* with privilege — the shared door (plan 75 §G2)."""+ """Write *content* to *path* with privilege — the shared door."""return write_privileged_file(path, content)@staticmethod@@ -430,7 +430,7 @@ bantime = {bantime}return cls.unban_ip(ip, cls.jail_name(app))# ------------------------------------------------------------------- # Fail2ban status probing + unban (plan 47 Ph3c inversion). These are+ # Fail2ban status probing + unban (inversion). These are# the read/undo half core keeps when the management surface moves to# the serverkit-fail2ban extension: Setup Health, the security audit# and the per-site jail status above all probe through here, and thediff --git a/backend/app/services/firewall_service.py b/backend/app/services/firewall_service.pyindex 49046d7b..63677017 100644--- a/backend/app/services/firewall_service.py+++ b/backend/app/services/firewall_service.py@@ -134,7 +134,7 @@ class FirewallService:# active|inactive" — both determined. A non-zero rc (e.g. an# unprivileged LXC, where ufw exists and is on PATH but fails on# dropped CAP_NET_ADMIN) or an exception is "could not check": None,- # never a fabricated inactive — the shape plan 74 warned about,+ # never a fabricated inactive — the shape a past outage warned about,# verified live in the §D capability-restricted container.active = None if installed else Falseerror = Nonediff --git a/backend/app/services/fleet_doctor_service.py b/backend/app/services/fleet_doctor_service.pyindex 6668a69c..6c055504 100644--- a/backend/app/services/fleet_doctor_service.py+++ b/backend/app/services/fleet_doctor_service.py@@ -1,5 +1,5 @@"""Fleet health doctor — the panel-host doctor, extended across the agent fleet-(Fleet Parity Sweep, plan 26 Phase 2-4).+(Fleet Parity Sweep).The panel-host :class:`doctor_service.DoctorService` answers "is *this* boxhealthy?" and stores a single ``doctor_last_report`` blob. This service answersdiff --git a/backend/app/services/fleet_monitor_service.py b/backend/app/services/fleet_monitor_service.pyindex e3a03dc3..8f2b8d74 100644--- a/backend/app/services/fleet_monitor_service.py+++ b/backend/app/services/fleet_monitor_service.py@@ -588,7 +588,7 @@ class FleetMonitorService:lines.append('# HELP serverkit_server_up Server online status')lines.append('# TYPE serverkit_server_up gauge')for server in servers:- # Honesty rule (plan 75 §A4): the up-series is exported only for+ # Honesty rule: the up-series is exported only for# servers whose connectivity was actually determined. A server# that was never probed — status pending/connecting, or never# seen (last_seen NULL) — emits NO series: exporting 0 would pagediff --git a/backend/app/services/fleet_repair_service.py b/backend/app/services/fleet_repair_service.pyindex 745f3a99..21be4120 100644--- a/backend/app/services/fleet_repair_service.py+++ b/backend/app/services/fleet_repair_service.py@@ -1,4 +1,4 @@-"""Allowlisted remote repairs over the agent (plan 26 Phase 5, Decision 6).+"""Allowlisted remote repairs over the agent.Remote mutations are dangerous, so they go through an explicit allowlist thatmaps a repair *kind* → the agent command it dispatches + the capability thediff --git a/backend/app/services/fleet_sweep.py b/backend/app/services/fleet_sweep.pyindex dc078dc5..a8adfa17 100644--- a/backend/app/services/fleet_sweep.py+++ b/backend/app/services/fleet_sweep.py@@ -1,5 +1,5 @@"""Bounded fan-out over connected agents — the one primitive every fleet-sweep reuses (Fleet Parity Sweep, plan 26, Decision 4).+sweep reuses (Fleet Parity Sweep).A "sweep" runs the same per-server probe across every targeted server, with abounded worker pool, a per-agent timeout, and a hard wall-clock budget so adiff --git a/backend/app/services/garage_admin.py b/backend/app/services/garage_admin.pyindex 0491b341..ed544d44 100644--- a/backend/app/services/garage_admin.py+++ b/backend/app/services/garage_admin.py@@ -1,4 +1,4 @@-"""Garage admin operations through its own CLI (plan 86 §C2).+"""Garage admin operations through its own CLI.``garage json-api <Endpoint> <payload>`` invokes the admin API over the node'sRPC socket and prints the JSON result, so the panel drives Garage withdiff --git a/backend/app/services/git_deploy_service.py b/backend/app/services/git_deploy_service.pyindex c1afdb67..3e292d2d 100644--- a/backend/app/services/git_deploy_service.py+++ b/backend/app/services/git_deploy_service.py@@ -106,7 +106,7 @@ class GitDeployService:raise Exception(f"Git pull failed: {pull_result.get('error')}")if not deployment.commit_sha:# A manual deploy names no commit: record what the pull- # checked out, never what was live before it (plan 87 §A2).+ # checked out, never what was live before it.head = run_checked(['git', 'rev-parse', 'HEAD'], cwd=app.root_path, timeout=10)if head['success']:deployment.commit_sha = head['output'].strip()[:40] or None@@ -393,7 +393,7 @@ class GitDeployService:The default webhook path. It used to go straight to ``compose down``,so a commit that broke the compose file or the build took the site down- and left it down (plan 72 B.1). The preflight now validates the compose+ and left it down. The preflight now validates the composeand builds the images to completion while the old containers are stillserving; only then is anything stopped."""@@ -411,7 +411,7 @@ class GitDeployService:passif getattr(app, 'slot_deploys_enabled', False):- # A slot app (plan 87 §C) never stops its live stack: the whole+ # A slot app never stops its live stack: the whole# deploy — preflight, slot boot, gate, switch, watch — runs through# the deploy pipeline, which records it as a Deployment too. The# deploy lock is already held by this thread.diff --git a/backend/app/services/git_service.py b/backend/app/services/git_service.pyindex 807f0447..420a7ae4 100644--- a/backend/app/services/git_service.py+++ b/backend/app/services/git_service.py@@ -467,7 +467,7 @@ class GitService:}# Emit a panel event so Automations (tramo) workflows can trigger on a- # git push through the events bridge (plan 45 Ph4, ported from the+ # git push through the events bridge (ported from the# retired Workflow Builder's 'git_push').try:from app.services.event_service import EventService@@ -484,7 +484,7 @@ class GitService:result = cls.deploy(app_id, trigger='webhook')# Push-to-reconfigure: re-read serverkit.yaml at the new commit and- # reconcile (plan 17 #17). Best-effort — never affects the deploy result.+ # reconcile. Best-effort — never affects the deploy result.try:from app.services.manifest_sync_service import ManifestSyncServicecommit = (payload.get('after')@@ -638,8 +638,8 @@ class GitService:# ------------------------------------------------------------------# The Gitea self-host half (install/lifecycle/config + repo browsing- # via GiteaAPIService) moved to the serverkit-git extension (plan 52- # Phase 6). Everything above IS the deploy pipeline and stays core:+ # via GiteaAPIService) moved to the serverkit-git extension.+ # Everything above IS the deploy pipeline and stays core:# apps.py / buildpacks.py / deploy.py / deployment_service.py /# manifest_apply_service.py import it, extension installed or not.# NginxService.create/remove/get_gitea_config remain core helpers thediff --git a/backend/app/services/grafana_provisioner.py b/backend/app/services/grafana_provisioner.pyindex 89ba5322..426132a6 100644--- a/backend/app/services/grafana_provisioner.py+++ b/backend/app/services/grafana_provisioner.py@@ -1,4 +1,4 @@-"""Wire an installed Grafana to Prometheus / Loki (plan 86 §A4).+"""Wire an installed Grafana to Prometheus / Loki.Attaching ``metrics`` (Prometheus) or ``logs`` (Loki) to a Grafana installcreates the data source through Grafana's HTTP API, at the loopback port itsdiff --git a/backend/app/services/health_gate.py b/backend/app/services/health_gate.pyindex 8b36c6a1..2f7ae549 100644--- a/backend/app/services/health_gate.py+++ b/backend/app/services/health_gate.py@@ -1,4 +1,4 @@-"""The deploy health gate (plan 87 §A3).+"""The deploy health gate.``_wait_for_health`` used to be advisory: it logged "did not pass" and thedeploy carried on as a success, and it counted a 4xx on the health path asdiff --git a/backend/app/services/history_retention_service.py b/backend/app/services/history_retention_service.pyindex cbdb2111..fc9eb24d 100644--- a/backend/app/services/history_retention_service.py+++ b/backend/app/services/history_retention_service.py@@ -1,4 +1,4 @@-"""Age out history tables that nothing else prunes (plan 85 A4).+"""Age out history tables that nothing else prunes.Every table here records something that already happened — an audit entry,a delivered notification, a finished cron run — and grew forever: no handlerdiff --git a/backend/app/services/install_profile_service.py b/backend/app/services/install_profile_service.pyindex b8b16a4f..e6c31d7a 100644--- a/backend/app/services/install_profile_service.py+++ b/backend/app/services/install_profile_service.py@@ -208,7 +208,7 @@ def get_capabilities(force_refresh=False):The profile says what was *intended*; this says what is *true*. They drift— an operator can apt-install Docker on a Minimal box, and a Standard boxcan have a broken daemon. Cached for _CAPABILITY_TTL_SECONDS because the- Docker probe can block (ttl_cached, plan 77 F2).+ Docker probe can block (ttl_cached)."""if force_refresh:_probe_capabilities.invalidate()diff --git a/backend/app/services/log_limits_service.py b/backend/app/services/log_limits_service.pyindex 5478bd53..971d4624 100644--- a/backend/app/services/log_limits_service.py+++ b/backend/app/services/log_limits_service.py@@ -1,4 +1,4 @@-"""Bound the log files ServerKit writes or causes (plan 85 A5).+"""Bound the log files ServerKit writes or causes.Four files grew without limit:@@ -34,7 +34,7 @@ def logrotate_config(log_dir):# copytruncate: gunicorn holds access/error.log open and is never told to# reopen them, so moving the file away would keep it writing to the old one.return (- '# Managed by ServerKit (plan 85 A5) - rewritten at panel start.\n'+ '# Managed by ServerKit - rewritten at panel start.\n'f'{paths} {{\n'' weekly\n'' maxsize 50M\n'diff --git a/backend/app/services/managed_database_service.py b/backend/app/services/managed_database_service.pyindex c9e2101f..b4f226dc 100644--- a/backend/app/services/managed_database_service.py+++ b/backend/app/services/managed_database_service.py@@ -91,7 +91,7 @@ class ManagedDatabaseService:@classmethoddef delete(cls, managed, drop=False, user_id=None):- """Delete a managed database (plan 77 B5, plan-70 semantics).+ """Delete a managed database (semantics).- ``drop=False``: SOFT delete — the row tombstones into the RecycleBin. The actual database on the server is untouched and any manageddiff --git a/backend/app/services/manifest_apply_service.py b/backend/app/services/manifest_apply_service.pyindex f794e415..e50b345d 100644--- a/backend/app/services/manifest_apply_service.py+++ b/backend/app/services/manifest_apply_service.py@@ -1,4 +1,4 @@-"""The manifest apply engine (plan 17, Phase 2).+"""The manifest apply engine.resolve → plan → apply. Turns a normalized v1 manifest into an ordered actionplan and executes it through the existing imperative services, inside a@@ -38,7 +38,7 @@ _SCHEDULE_CRON = {# db engines the managed-database layer can actually record_MANAGED_DB_ENGINES = {'postgresql', 'mysql'}# manifest db types provisioned by installing the engine template of the same-# id (plan 86 §C3); consumers bind with fromService over the shared network+# id; consumers bind with fromService over the shared network_ENGINE_TEMPLATE_TYPES = {'redis': 'redis'}# ordering weight per step type (dbs before consumers; domains last)@@ -201,7 +201,7 @@ class ManifestApplyService:expected['healthcheck_path'] = resolved['healthcheck_path']observed['healthcheck_path'] = app.healthcheck_path- # Appliance tier (plan 35): track raw ports + BYO image.+ # Appliance tier: track raw ports + BYO image.declared_ports = resolved.get('ports') or []if declared_ports:from app.services.app_port_service import AppPortService@@ -266,7 +266,7 @@ class ManifestApplyService:steps.extend(cls._plan_domains(project, normalized.get('domains', [])))- # Appliance-tier blockers (plan 35): plan-time refusals distinct from+ # Appliance-tier blockers: plan-time refusals distinct from# advisory `issues`. Apply refuses (nothing executed) while any exist.blockers, appliance_issues = cls._appliance_blockers(project, resolved_all)issues.extend(appliance_issues)@@ -333,7 +333,7 @@ class ManifestApplyService:('app_type', 'port', 'healthcheck_path', 'runtime','build_command', 'start_command', 'cpu', 'memory')}payload['name'] = name- # BYO image (plan 35): stamp the declared image + private registry+ # BYO image: stamp the declared image + private registryif resolved.get('image'):payload['image'] = resolved['image']if resolved.get('registry'):@@ -370,7 +370,7 @@ class ManifestApplyService:'payload': {'app_id': app.id, 'changes': changes},})- # typed L4 port publishes (appliance tier, plan 35)+ # typed L4 port publishes (appliance tier)ports = resolved.get('ports') or []if ports:from app.services.app_port_service import AppPortService@@ -445,13 +445,13 @@ class ManifestApplyService:'files', app.id if app else None, backup):steps.append(cls._files_backup_step(name, app, mount, backup))- # unit disk backups (plan 35) — the bytes live in a synthetic per-container+ # unit disk backups — the bytes live in a synthetic per-container# docker volume, so the backup routes at that volume name.for ub in resolved.get('unit_backups') or []:if not cls._backup_policy_current('files', app.id if app else None, ub['backup']):steps.append(cls._unit_backup_step(name, app, ub))- # first-boot bootstrap (appliance tier, plan 35) — once per app; a unit+ # first-boot bootstrap (appliance tier) — once per app; a unit# runs each of its containers' bootstraps under the one bootstrap_done flagbootstraps = resolved.get('bootstraps') or []if bootstraps and (app is None or not getattr(app, 'bootstrap_done', False)):@@ -517,7 +517,7 @@ class ManifestApplyService:'schedule': backup['schedule'], 'retain': backup['retain']},}- # -- blockers engine (appliance tier, plan 35) --------------------------+ # -- blockers engine (appliance tier) --------------------------# An appliance FEATURE is anything the manifest can now express that a# target may be unable to provide. Later phases extend `_service_features`.@@ -551,7 +551,7 @@ class ManifestApplyService:name = resolved['name']server_ref = resolved.get('server')- # fromServer publicIp must resolve (plan 35) — independent of the+ # fromServer publicIp must resolve — independent of the# other appliance features; a service may bind only its own IP.needs_ip = any(r.get('source') == 'server'@@ -580,7 +580,7 @@ class ManifestApplyService:continueneed = ' and '.join(feats)- # Remote target: appliance apply runs on the panel host only (plan 17's+ # Remote target: appliance apply runs on the panel host only (the manifest engine's# remote-dispatch deferral). Say so instead of half-deploying.if server_ref:srv = cls._resolve_server_obj(server_ref)@@ -624,7 +624,7 @@ class ManifestApplyService:'message': f'no manageable firewall detected — public ports for {name} 'f'will be published but not firewall-managed.'})- # BYO image (plan 35): a private registry must be known + credentialed.+ # BYO image: a private registry must be known + credentialed.for ref in cls._image_registry_refs(resolved):reg_name = ref.get('registry')if not reg_name:@@ -638,7 +638,7 @@ class ManifestApplyService:+ ('unknown' if reg is None else 'missing a stored credential')+ f' — add the registry credential, then re-apply.'})- # Host requirements (plan 35): listed in plain words, never silent.+ # Host requirements: listed in plain words, never silent.for hr in resolved.get('host_requirements') or []:for phrase in cls._hostreq_phrases(hr):issues.append({'service': name, 'kind': 'host_requirement',@@ -800,7 +800,7 @@ class ManifestApplyService:env = environment or cls._default_environment(project)plan = cls.plan(project, normalized, env)- # Appliance-tier blockers (plan 35): refuse before executing anything.+ # Appliance-tier blockers: refuse before executing anything.# No force flag — the operator must clear the cause and re-apply.if plan.get('blockers'):if manifest_row is not None:@@ -836,7 +836,7 @@ class ManifestApplyService:cls._finish_job(job, failed, results)- # Host requirements never apply silently (plan 35): audit every one.+ # Host requirements never apply silently: audit every one.hr_issues = [i for i in plan.get('issues', []) if i.get('kind') == 'host_requirement']if hr_issues:try:@@ -1080,7 +1080,7 @@ class ManifestApplyService:if any(v.mount_path == payload['mount_path'] for v in (app.volumes or [])):return {'exists': True}vol = VolumeService.create(app, payload['name'], payload['mount_path'])- # persist the manifest-declared size cap (plan 35); measured usage stays+ # persist the manifest-declared size cap; measured usage stays# on size_bytes.declared = payload.get('size')if declared is not None and vol is not None:@@ -1143,7 +1143,7 @@ class ManifestApplyService:return {'policy': 'database', 'db': payload['db_name']}# files — for a manifest disk the real bytes live in the named docker# volume, so record the volume mount so backup resolves the live HOST- # mountpoint (plan 35). `paths` stays as a graceful fallback.+ # mountpoint. `paths` stays as a graceful fallback.app_id = payload.get('app_id') or cls._resolve_app_id(project, payload)meta = {'paths': [payload['mount_path']], 'managed_by': 'manifest'}if payload.get('volume_mount'):diff --git a/backend/app/services/manifest_persistence_service.py b/backend/app/services/manifest_persistence_service.pyindex c90cc756..0eb9ea45 100644--- a/backend/app/services/manifest_persistence_service.py+++ b/backend/app/services/manifest_persistence_service.py@@ -1,4 +1,4 @@-"""Persist a detected manifest and seed what it declares (plan 17, Phase 1).+"""Persist a detected manifest and seed what it declares.Stops the import flow from discarding what `RepositoryManifestService` alreadyparses: the health-check path, the manifest env, and (for v1 manifests) thediff --git a/backend/app/services/manifest_preview_service.py b/backend/app/services/manifest_preview_service.pyindex 563b4dfa..23b1b71f 100644--- a/backend/app/services/manifest_preview_service.py+++ b/backend/app/services/manifest_preview_service.py@@ -1,4 +1,4 @@-"""Manifest-powered previews (plan 17, Phase 5, #20).+"""Manifest-powered previews.A PR preview for a manifest-managed app is an apply with a namespace prefix anda TTL: it clones the manifest-resolved config (env + the existingdiff --git a/backend/app/services/manifest_scaffold_service.py b/backend/app/services/manifest_scaffold_service.pyindex eb82c43f..b74d1890 100644--- a/backend/app/services/manifest_scaffold_service.py+++ b/backend/app/services/manifest_scaffold_service.py@@ -46,7 +46,7 @@ class ManifestScaffoldService:if app.port:service['port'] = app.port- # Appliance tier (plan 35): round-trip a BYO image + typed L4 ports.+ # Appliance tier: round-trip a BYO image + typed L4 ports.# A Dockerfile-built app round-trips its build config instead — its# recorded docker_image is the build artifact, not a declaration.from app.services.build_service import BuildServicediff --git a/backend/app/services/manifest_spec_service.py b/backend/app/services/manifest_spec_service.pyindex a41976d7..62512b51 100644--- a/backend/app/services/manifest_spec_service.py+++ b/backend/app/services/manifest_spec_service.py@@ -57,16 +57,16 @@ FROM_SERVICE_PROPERTIES = ('connectionString', 'host', 'port', 'database', 'username', 'password', 'url',)-# Appliance tier (plan 35): a service's own advertised identity.+# Appliance tier: a service's own advertised identity.FROM_SERVER_PROPERTIES = ('publicIp', 'hostname')BACKUP_SCHEDULES = ('hourly', 'daily', 'weekly', 'monthly')-# Appliance tier (plan 35): typed L4 port publishes.+# Appliance tier: typed L4 port publishes.PORT_PROTOCOLS = ('tcp', 'udp')PORT_EXPOSURES = ('public', 'local')-# Recipes (plan 68): the execution type is deliberately small and closed. The+# Recipes: the execution type is deliberately small and closed. The# ``kind`` within each type is capability-gated by the runtime registry, so a# catalog entry can never smuggle an arbitrary command into an older panel.RECIPE_STEP_TYPES = ('probe', 'derive', 'apply', 'handoff', 'verify')@@ -675,7 +675,7 @@ class ManifestSpecService:@classmethoddef _normalize_ports(cls, raw: Any, prefix: str, errors: List[str]) -> List[Dict[str, Any]]:- """Typed L4 publishes (plan 35). Legacy scalar ``port`` is unaffected —+ """Typed L4 publishes. Legacy scalar ``port`` is unaffected —it keeps its HTTP/nginx semantics. ``ports`` are raw tcp/udp publishes(the appliance escape hatch): NULL/[] means "no raw ports declared"."""@@ -709,7 +709,7 @@ class ManifestSpecService:@classmethoddef _normalize_bootstrap(cls, raw: Any) -> Optional[Dict[str, Any]]:- """First-boot bootstrap (plan 35): ``{command, timeoutSeconds?}``."""+ """First-boot bootstrap: ``{command, timeoutSeconds?}``."""if not isinstance(raw, dict):return Nonecommand = raw.get('command')@@ -723,7 +723,7 @@ class ManifestSpecService:@classmethoddef _normalize_host_requirements(cls, raw: Any) -> Optional[Dict[str, Any]]:- """hostRequirements (plan 35): privileged/capAdd/sysctls/devices/kernelModules."""+ """hostRequirements: privileged/capAdd/sysctls/devices/kernelModules."""if not isinstance(raw, dict):return Nonehr = {@@ -770,7 +770,7 @@ class ManifestSpecService:@classmethoddef _normalize_containers(cls, svc: Dict[str, Any], prefix: str,errors: List[str]) -> List[Dict[str, Any]]:- """A multi-container unit (plan 35, Decision 6). ``containers`` is a+ """A multi-container unit. ``containers`` is amapping of name -> container spec, rendered as ONE compose project.Mutually exclusive with the buildpack keys; dependsOn must reference adiff --git a/backend/app/services/manifest_sync_service.py b/backend/app/services/manifest_sync_service.pyindex 3293a58b..62cae5ae 100644--- a/backend/app/services/manifest_sync_service.py+++ b/backend/app/services/manifest_sync_service.py@@ -1,4 +1,4 @@-"""Push-to-reconfigure — re-read serverkit.yaml on every deploy (plan 17, Phase 4).+"""Push-to-reconfigure — re-read serverkit.yaml on every deploy.Both webhook receivers call ``resync_for_app`` after a deploy. If the manifesthash is unchanged it is a no-op (today's behavior). If it changed, services withdiff --git a/backend/app/services/member_action_service.py b/backend/app/services/member_action_service.pyindex 46ac154e..594fc862 100644--- a/backend/app/services/member_action_service.py+++ b/backend/app/services/member_action_service.py@@ -1,4 +1,4 @@-"""Member action templates — the safe write escape hatch (plan 19 Phase 5).+"""Member action templates — the safe write escape hatch.A member action is a CURATED, parameterized action a workspace member may triggerfor an app they can reach. It is the only member-write path beyond the plan's@@ -15,7 +15,7 @@ Phase-4 matrix, and it is deliberately narrow:The registry ships one concrete template today — `set-backup-frequency`, whichadjusts an app's backup schedule through the existing BackupPolicyService (no newside-channel). The cron "ping this app's scheduler every N minutes" template-named in the plan is deferred until plan 21 #10 lands its ScheduledJob wiring;+named in the plan is deferred until its ScheduledJob wiring lands;adding it is just another registry entry."""from app.services.resource_grant_service import ResourceGrantService@@ -112,7 +112,7 @@ MEMBER_ACTIONS = {def is_enabled():"""Feature flag — the whole member-action surface can be turned off.- Two independent kill switches, both must allow (plan 29 #13): the+ Two independent kill switches, both must allow: the``MEMBER_ACTIONS_ENABLED`` app config (deployment-level, default ON) AND theadmin-visible ``security_member_actions_enabled`` system setting (default ON).Either set to false disables the surface."""diff --git a/backend/app/services/metrics_token_service.py b/backend/app/services/metrics_token_service.pyindex 83094fd5..985e4eae 100644--- a/backend/app/services/metrics_token_service.py+++ b/backend/app/services/metrics_token_service.py@@ -1,4 +1,4 @@-"""The panel's Prometheus scrape token (plan 86 §A4).+"""The panel's Prometheus scrape token.``/api/v1/fleet-monitor/prometheus`` only accepted a ``PROMETHEUS_TOKEN`` set inthe environment, which almost no install sets, so an installed Prometheus haddiff --git a/backend/app/services/monitor_service.py b/backend/app/services/monitor_service.pyindex 53aad959..df370ae8 100644--- a/backend/app/services/monitor_service.py+++ b/backend/app/services/monitor_service.py@@ -118,7 +118,7 @@ class MonitorService:With the WordPress extension absent (or the site removed) the bindfails loudly here instead of creating an orphan monitor that never- gets health-synced (plan 52 task 17). The model itself stays core+ gets health-synced (task 17). The model itself stays core(D1), so the check is a plain row lookup."""if site_id is None:diff --git a/backend/app/services/monitoring_service.py b/backend/app/services/monitoring_service.pyindex c8ce3052..cba6d702 100644--- a/backend/app/services/monitoring_service.py+++ b/backend/app/services/monitoring_service.py@@ -298,7 +298,7 @@ class MonitoringService:)# Emit panel events so Automations (tramo) workflows can trigger on a- # high-CPU/memory alert through the events bridge (plan 45 Ph4, ported+ # high-CPU/memory alert through the events bridge (ported# from the retired Workflow Builder's 'high_cpu'/'high_memory').try:from app.services.event_service import EventServicediff --git a/backend/app/services/nginx_advanced_service.py b/backend/app/services/nginx_advanced_service.pyindex 95152dde..8b4b0c82 100644--- a/backend/app/services/nginx_advanced_service.py+++ b/backend/app/services/nginx_advanced_service.py@@ -10,9 +10,9 @@ class NginxAdvancedService:"""Read-side nginx helpers: vhost config, config test, diff preview, logs.The reverse-proxy / load-balancer builder was removed with the scaling- pieces (plan 86 §E2): one live copy per app, no upstream pools."""+ pieces: one live copy per app, no upstream pools."""- # NginxService owns these (plan 75 §G4). Hardcoding them here meant an+ # NginxService owns these. Hardcoding them here meant an# NGINX_CONF_DIR override — the env var NginxService honours, and what# tests redirect — silently did not apply to this service.NGINX_CONF_DIR = NginxService.NGINX_CONF_DIR@@ -34,7 +34,7 @@ class NginxAdvancedService:@staticmethoddef test_config():- """Test nginx config syntax — NginxService owns the call (plan 75 §G4).+ """Test nginx config syntax — NginxService owns the call.Kept as a distinct method because its result shape (``valid``/``output``) is what this service's API consumers read.@@ -70,7 +70,7 @@ class NginxAdvancedService:@staticmethoddef reload_nginx():- """Reload nginx — NginxService owns it (plan 75 §G4).+ """Reload nginx — NginxService owns it.The private version ran `nginx -s reload` with no config test first, soa broken vhost written by this same service reloaded straight intodiff --git a/backend/app/services/nginx_service.py b/backend/app/services/nginx_service.pyindex c4298ec2..dbac5979 100644--- a/backend/app/services/nginx_service.py+++ b/backend/app/services/nginx_service.py@@ -363,7 +363,7 @@ location = /wordpress {{}}'''- # ==================== TIMED ACCESS LOG (plan 86 §A1) ====================+ # ==================== TIMED ACCESS LOG ====================# Every vhost ServerKit writes logs in this format. The combined fields come# first, unchanged, so every existing combined-format reader (bandwidth# accounting, the fail2ban `^<HOST> -` filters) keeps matching; the timing@@ -380,7 +380,7 @@ log_format serverkit_timed '$remote_addr - $remote_user [$time_local] "$request"'cs=$upstream_cache_status h=$host';"""- # ==================== COMPRESSION (plan 86 §B1) ====================+ # ==================== COMPRESSION ====================# gzip (and brotli when the module is loaded) for every site, as one# http-level conf.d snippet. Stock configs already set some of these —# Debian's nginx.conf ships `gzip on;` — and a repeated http-level@@ -409,7 +409,7 @@ log_format serverkit_timed '$remote_addr - $remote_user [$time_local] "$request"('brotli_types', COMPRESSION_TYPES),)- # ==================== IMMUTABLE ASSETS (plan 86 §B2) ====================+ # ==================== IMMUTABLE ASSETS ====================# Opt-in, proxied sites only: a fingerprinted asset (a hash in its name)# never changes, so the browser may keep it a year. Off by default because# the panel cannot know an app's asset layout. The hash must be 8+ chars@@ -433,7 +433,7 @@ log_format serverkit_timed '$remote_addr - $remote_user [$time_local] "$request"# per site does not scale (and can't be added/removed without touching a# global file per site). Purge is still per site: the cache key carries# $host, and purge_micro_cache(hosts) deletes only the files whose KEY- # line names that host (plan 86 §B3). proxy_* and fastcgi_* caches cannot+ # line names that host. proxy_* and fastcgi_* caches cannot# share a keys_zone, hence two zones over one base directory.MICROCACHE_CONF_NAME = 'serverkit-microcache.conf'MICROCACHE_DIR = '/var/cache/nginx/serverkit-microcache'@@ -459,7 +459,7 @@ fastcgi_cache_path /var/cache/nginx/serverkit-microcache/fastcgi levels=1:2 keysif ($request_uri ~* "^/(wp-admin|wp-login|admin|login|cart|checkout|my-account)") { set $sk_skip_cache 1; }'''- # Page-cache behaviour (plan 86 §B3):+ # Page-cache behaviour:# * the key is `$scheme://$host$request_uri`, so the cache files of one# site can be found by host and purged alone (the proxy default key is# `$scheme$proxy_host$request_uri` — the upstream port, not the site);@@ -787,7 +787,7 @@ location /p/ {{match = re.search(r'^ location / \{\n(.*?)^ \}\n', config, re.MULTILINE | re.DOTALL)if not match:return config- block = ('\n # ServerKit: fingerprinted assets never change (plan 86 §B2)\n'+ block = ('\n # ServerKit: fingerprinted assets never change\n'f' location ~* "{cls.IMMUTABLE_ASSET_PATTERN}" {{\n'+ match.group(1) + cls.IMMUTABLE_ASSET_HEADERS + ' }\n')return config[:match.end()] + block + config[match.end():]@@ -950,7 +950,7 @@ location /p/ {{@classmethoddef ensure_compression(cls) -> Dict:- """Write the compression snippet once, best-effort (plan 86 §B1).+ """Write the compression snippet once, best-effort.Skips when the snippet exists. A snippet that fails ``nginx -t`` isremoved again, so compression can never take the web server down —@@ -985,7 +985,7 @@ location /p/ {{def purge_micro_cache(cls, hosts: Optional[List[str]] = None) -> Dict:"""Clear cached pages. Linux-only; no nginx reload needed.- With ``hosts`` only that site's entries go (plan 86 §B3). nginx writes+ With ``hosts`` only that site's entries go. nginx writeseach entry's key as a ``KEY: <scheme>://<host><uri>`` header line inthe cache file, so a fixed-string grep for ``KEY: http[s]://<host>/``finds exactly this site's files; the trailing ``/`` keepsdiff --git a/backend/app/services/plugin_service.py b/backend/app/services/plugin_service.pyindex 89b390dc..4eda03a7 100644--- a/backend/app/services/plugin_service.py+++ b/backend/app/services/plugin_service.py@@ -66,18 +66,18 @@ BUILTIN_EXTENSIONS_DIR = os.environ.get(# file copy — its backend loads straight from builtin-extensions/ and its frontend# is pre-bundled (D5). A user uninstall records a marker so it stays gone.#-# serverkit-wordpress GRADUATED from this list in plan 52 Phase 5: it left the+# serverkit-wordpress GRADUATED from this list: it left the# tree into its own repo and now distributes through the registry (the# k8s/tramo model — bundled index entry + GitHub release zip), offered during# onboarding via RECOMMENDED_EXTENSIONS_BY_USE_CASE. Its uninstall-marker# semantics are preserved (the settings key machinery below is untouched), so# a user who uninstalled WP before the extraction is never re-seeded.-FLAGSHIP_SLUGS = [] # cloudflare-ops left the tree (plan 52 Ph2 cutover); machinery kept for future flagships+FLAGSHIP_SLUGS = [] # cloudflare-ops left the tree (cutover); machinery kept for future flagships_FLAGSHIP_UNINSTALLED_KEY = 'extensions.flagship_uninstalled'-# Wizard-optional flagships (plan 47): offered — not force-installed — during+# Wizard-optional flagships: offered — not force-installed — during# onboarding. Currently EMPTY: WordPress (the only member) left the tree in-# plan 52 Phase 5 and is now a registry extension the wizard offers like any+# its own repo and is now a registry extension the wizard offers like any# other recommendation. The machinery stays — a future in-tree flagship that# should be wizard-optional goes here.WIZARD_OPTIONAL_FLAGSHIP_SLUGS = []@@ -672,8 +672,8 @@ def install_from_url(url, user_id=None, expected_sha256=None, force=False,expected_sha256: if given, the downloaded zip must match this digestbefore extraction — a mismatch is a hard failure (no partial install)expected_signature / expected_key_id: if given, the downloaded zip is- verified against this base64 ed25519 signature envelope (plan 55- D3) under the pinned publisher key named by expected_key_id. A bad+ verified against this base64 ed25519 signature envelope under the+ pinned publisher key named by expected_key_id. A badsignature is a hard failure; an unpinned key installs but isrecorded as 'untrusted_key'.force: allow reinstalling over an already-active plugin (used by updates)@@ -791,7 +791,7 @@ def preview_from_url(url):buf.seek(0)manifest = _read_manifest_from_buffer(buf)- # Signature verdict for the consent card (plan 55): the detached .minisig+ # Signature verdict for the consent card: the detached .minisig# beside the release asset, verified against the panel's pinned publisher# keys. Unsigned is a verdict, not an error — the card says so honestly.sig_b64 = _fetch_detached_signature(resolved)@@ -1099,7 +1099,7 @@ def _install_from_buffer(buf, source_url, source_type, user_id=None, force=False# them runs pip with the backend's privileges, which means# arbitrary code via setup.py hooks. Operators must opt in# by setting SERVERKIT_ALLOW_PLUGIN_PIP=1.- # Same predicate the admin surface reports (plan 55 task 6)+ # Same predicate the admin surface reports (task 6)# — if the two ever disagreed, the page would describe a# behaviour the installer does not have.req_content = zf.read(member).decode('utf-8')@@ -1160,7 +1160,7 @@ def _install_from_buffer(buf, source_url, source_type, user_id=None, force=Falseplugin.entry_point = entry_pointplugin.url_prefix = url_prefixplugin.frontend_entry = manifest.get('frontend_entry', '')- # Runtime-frontend integrity (plan 25 #6, core-slim #39): pin the sha256+ # Runtime-frontend integrity (core-slim #39): pin the sha256# of the prebuilt ESM bundle so the client loader can verify the bytes it# blob-imports match what was installed. No-op for baked .jsx builtins.if has_frontend:@@ -1872,7 +1872,7 @@ def plugin_pip_enabled():def pending_requirements(plugin):- """The Python dependencies an install declined to pip-install (plan 55).+ """The Python dependencies an install declined to pip-install.When the opt-in is off, install writes the plugin's requirements.txt intoits backend dir and moves on with a log line nobody reads — the extension@@ -1929,7 +1929,7 @@ def pending_requirements(plugin):# Plugin-config keys the panel owns — never user-editable, preserved across a# config PUT. The runtime-frontend loader's per-bundle sha256 hashes live here,-# and so does the install-time signature verdict (plan 55).+# and so does the install-time signature verdict.RESERVED_PLUGIN_CONFIG_KEYS = ('_frontend_hashes', '_signature')@@ -2025,7 +2025,7 @@ def list_builtin_extensions():return out-# ── Onboarding wizard: use-case → recommended extension slugs (plan 47) ──+# ── Onboarding wizard: use-case → recommended extension slugs ──## Drives the setup wizard's "Recommended for you" install checkboxes. Every slug# here MUST resolve to a real bundled builtin (builtin-extensions/) or a registry@@ -2097,7 +2097,7 @@ def recommend_extensions_for_use_cases(use_cases):return out-# Wizard round 2 (plan 47 Ph5): "How much security tooling?" The extracted+# Wizard round 2: "How much security tooling?" The extracted# security suite installs by chosen posture, not per-tool nagging. Slugs here# resolve through the same catalog index as the use-case map — an entry that# is not yet published (or a registry that is unreachable) silently drops out,@@ -2134,7 +2134,7 @@ def finalize_setup_flagships():"""Keep the panel lean after onboarding completes: any wizard-optionalflagship (WordPress) the user didn't install during the wizard gets theuninstall marker so the boot-time flagship seeder won't re-add it on later- boots. Called from the complete-onboarding endpoint (plan 47)."""+ boots. Called from the complete-onboarding endpoint."""for slug in WIZARD_OPTIONAL_FLAGSHIP_SLUGS:if not InstalledPlugin.query.filter_by(slug=slug).first():_set_flagship_uninstalled(slug, True)@@ -2144,7 +2144,7 @@ def get_installed_extension_attr(slug, module, attr, default=None):"""Return ``attr`` from an installed extension's backend module, else default.A core seam that calls into a feature which now lives in an extracted- extension (plan 47) uses this so it no-ops cleanly when the extension isn't+ extension uses this so it no-ops cleanly when the extension isn'tinstalled. Resolves ``app.plugins.<slug>.<module>`` (the dashed package theplugin loader wires up on install); any import/lookup failure yields``default``."""@@ -2285,7 +2285,7 @@ def _seed_flagship_row(entry):def _wizard_optional_flagships_suppressed():"""True when wizard-optional flagships (WordPress) should NOT be boot-seeded:- a fresh install whose setup wizard hasn't completed (plan 47).+ a fresh install whose setup wizard hasn't completed.Bypassed under TESTING so the extensive WordPress test suite keeps itsseeded flagship; the real gate is exercised by dedicated proving tests that@@ -2316,7 +2316,7 @@ def seed_flagship_extensions():for slug in FLAGSHIP_SLUGS:if slug in uninstalled:continue- # Fresh install (plan 47): don't seed wizard-optional flagships (WordPress)+ # Fresh install: don't seed wizard-optional flagships (WordPress)# until the setup wizard installs them. Existing/completed-setup installs# fall through and seed as before.if suppress_optional and slug in WIZARD_OPTIONAL_FLAGSHIP_SLUGS:@@ -2361,7 +2361,7 @@ def install_registry_extension(slug, user_id=None):"""Install an extension listed in the remote registry (checksum-verified).When the index entry carries a ``signature``/``publisher_key_id`` pair- (index schema v3, plan 55 D3) the downloaded zip is also verified against+ (index schema v3) the downloaded zip is also verified againstthe panel's pinned publisher keys — a bad signature is a hard failureeven when the sha256 matches."""from app.services import registry_servicediff --git a/backend/app/services/pooler_service.py b/backend/app/services/pooler_service.pyindex 7cda6252..ceae60c7 100644--- a/backend/app/services/pooler_service.py+++ b/backend/app/services/pooler_service.py@@ -1,4 +1,4 @@-"""Opt-in PgBouncer beside an installed PostgreSQL (plan 86 §D1).+"""Opt-in PgBouncer beside an installed PostgreSQL.Turning pooling on adds a ``pgbouncer`` service to the PostgreSQL app'smanaged compose override: same project, container ``<app>-pooler``, on thediff --git a/backend/app/services/registry_service.py b/backend/app/services/registry_service.pyindex 3cc3310e..459d8111 100644--- a/backend/app/services/registry_service.py+++ b/backend/app/services/registry_service.py@@ -60,7 +60,7 @@ _FIELDS = {'max_panel_version': None,'source': '','sha256': None,- # Index schema v3 (plan 55 D3): optional ed25519 detached signature over+ # Index schema v3: optional ed25519 detached signature over# the release zip + the publisher key id that must verify it. Absent in# v1/v2 indexes → the entry is treated as unsigned (consent, not a block).'signature': None,@@ -156,7 +156,7 @@ def _read_index_payload(payload, base_url=None):return [e for e in (_normalize(x, base_url) for x in exts) if e]-# One remote-catalog engine (plan 77 F1): fetch -> TTL -> last-good ->+# One remote-catalog engine: fetch -> TTL -> last-good -># bundled, with the failure-retry throttling theme_registry had already# hardened to. This module stays a thin normalizer (_read_index_payload)._index = CachedRemoteIndex(diff --git a/backend/app/services/release_phase_service.py b/backend/app/services/release_phase_service.pyindex d282cf8e..9f658d09 100644--- a/backend/app/services/release_phase_service.py+++ b/backend/app/services/release_phase_service.py@@ -1,4 +1,4 @@-"""Pre-switch phases of a slot deploy: DB snapshot and release command (plan 87 §D).+"""Pre-switch phases of a slot deploy: DB snapshot and release command.Both slots talk to the same database, so anything that changes it runsexactly once, BEFORE the switch, while the old release still serves:diff --git a/backend/app/services/remote_cron_service.py b/backend/app/services/remote_cron_service.pyindex 782d9cfe..c23afd57 100644--- a/backend/app/services/remote_cron_service.py+++ b/backend/app/services/remote_cron_service.py@@ -14,8 +14,8 @@ Action mapping (panel → agent):cron:remove -> {success: true}cron:toggle -> {success: true, enabled}-cron:update is the first cron verb gated on a v2 capability (cron.update,-plan 28): agents older than 1.2.0 never advertise it, so we refuse cleanly+cron:update is the first cron verb gated on a v2 capability (cron.update):+agents older than 1.2.0 never advertise it, so we refuse cleanlywith a friendly "agent too old" 503 rather than dispatching a command theagent will reject as unknown.diff --git a/backend/app/services/remote_docker_service.py b/backend/app/services/remote_docker_service.pyindex afb68c56..1f846359 100644--- a/backend/app/services/remote_docker_service.py+++ b/backend/app/services/remote_docker_service.py@@ -374,7 +374,7 @@ class RemoteDockerService:return flatdef h(value):- # Probe honesty (plan 75 §A3): a counter the agent could not+ # Probe honesty: a counter the agent could not# determine stays None — never 0, which would render as a real# reading — and gets no human string.return cls._human_bytes(value) if value is not None else Nonediff --git a/backend/app/services/request_metrics_service.py b/backend/app/services/request_metrics_service.pyindex 82f133c5..4c537d6b 100644--- a/backend/app/services/request_metrics_service.py+++ b/backend/app/services/request_metrics_service.py@@ -1,4 +1,4 @@-"""Per-app request rate, errors and latency from nginx access logs (plan 86 §A2).+"""Per-app request rate, errors and latency from nginx access logs.A one-minute builtin tick (``builtin.request_metrics``) tails each live app's``/var/log/nginx/<app>.access.log`` from a stored byte offset. It never@@ -10,7 +10,7 @@ re-parses a whole day, and it rolls the new lines up intoBoth levels are written on ingest, and old rows are pruned on the same tick,so the table's size is bounded from day one. Tables like this one filled the-disk before (plan 85).+disk before.Lines in the timed format (``NginxService.TIMED_LOG_FORMAT``) contributelatency and cache status. Plain combined lines, from vhosts written before the@@ -358,7 +358,7 @@ class RequestMetricsService:# Only live apps' cursors are kept, so a deleted app's entry goes too.if new_cursors != cursors:SystemSettings.set(CURSOR_SETTING_KEY, new_cursors, value_type='json',- description='Request-metrics log offsets (plan 86 §A2)')+ description='Request-metrics log offsets')db.session.commit()if stats['skipped_bytes']:logger.info('request metrics skipped %d backlog bytes',diff --git a/backend/app/services/resource_grant_service.py b/backend/app/services/resource_grant_service.pyindex a48d6f1f..22af226b 100644--- a/backend/app/services/resource_grant_service.py+++ b/backend/app/services/resource_grant_service.py@@ -62,7 +62,7 @@ class ResourceGrantService:"""Operate (member+) access to an application. Folds every path to theapp into one capability tier (see rbac.app_access_tier) and admitsanyone at 'member' or above: owner, panel admin, an editor grant, or a- workspace member/admin/owner. The member-write seam (plan 19 Phase 4)."""+ workspace member/admin/owner. The member-write seam."""from app.middleware.rbac import app_access_tier, _APP_ROLE_RANKtier = app_access_tier(user, app)return tier is not None and _APP_ROLE_RANK[tier] >= _APP_ROLE_RANK['member']diff --git a/backend/app/services/resource_tier_service.py b/backend/app/services/resource_tier_service.pyindex f0ba94f3..64374440 100644--- a/backend/app/services/resource_tier_service.py+++ b/backend/app/services/resource_tier_service.py@@ -30,8 +30,8 @@ import psutillogger = logging.getLogger(__name__)-# Specs and the tier label are stable enough to cache for an hour (ttl_cached,-# plan 77 F2); headroom is recomputed on every call because it is the number+# Specs and the tier label are stable enough to cache for an hour+# (ttl_cached); headroom is recomputed on every call because it is the number# that moves. _probe_count lets get_resource_tier report whether this response# came from cache without a second bookkeeping dict._TIER_TTL_SECONDS = 3600@@ -146,7 +146,7 @@ class ResourceTierService:"""Volume to measure free space on — where images and backups land.Delegates to host_inventory_service so this and capacity_service can no- longer answer the same question differently (plan 74).+ longer answer the same question differently."""from app.services import host_inventory_servicereturn host_inventory_service.data_path()diff --git a/backend/app/services/restore_point_adapter_nginx.py b/backend/app/services/restore_point_adapter_nginx.pyindex f1c146a9..75d745ef 100644--- a/backend/app/services/restore_point_adapter_nginx.py+++ b/backend/app/services/restore_point_adapter_nginx.py@@ -54,7 +54,7 @@ def _slot_app(name):def _slot_state(name, content):- """Which slot the captured vhost points at (plan 87).+ """Which slot the captured vhost points at.A slot app's vhost proxies to the live slot's port; restoring the filewithout restoring the slot would point nginx at a standby that may bediff --git a/backend/app/services/run_log_service.py b/backend/app/services/run_log_service.pyindex fb9e1c1b..35381432 100644--- a/backend/app/services/run_log_service.py+++ b/backend/app/services/run_log_service.py@@ -7,7 +7,7 @@ truthful in-memory tail of the last output for failure reporting, records per-sttimings, sanitizes ANSI/`\\r` noise, caps the persisted row count, and matches aplain-language hint against the failure output.-Design contract (plan 51, D4/D5/D6/D10):+Design contract:- ``stream.log(level, message, step_index=None, data=None)`` — NEVER raises.- ``stream.set_step(index, name)`` — flush, update the job row, emit a status.@@ -145,7 +145,7 @@ def _make_default_emit_status(run_kind: str) -> Callable:class RunLogStream:"""Batched, crash-proof log writer for one run.- Generalized (plan 77 E1) over any model implementing the small RunLike+ Generalized over any model implementing the small RunLikeprotocol: an ``id``, a ``__run_kind__`` class attribute, a ``to_dict()``for status emits, and — optionally — ``get_result``/``set_result`` (forclose-time enrichment) and ``current_step``/``current_step_name`` (fordiff --git a/backend/app/services/search_service.py b/backend/app/services/search_service.pyindex e44e68a3..62adecb6 100644--- a/backend/app/services/search_service.py+++ b/backend/app/services/search_service.py@@ -1,4 +1,4 @@-"""Unified entity omnisearch (plan 41, Phase 4).+"""Unified entity omnisearch.Fans a short search term out across the panel's core entity types and returns aflat list of lightweight, deep-linkable rows. Each entity type reuses itsdiff --git a/backend/app/services/security_policy_service.py b/backend/app/services/security_policy_service.pyindex 2635f9d5..1ac16cc2 100644--- a/backend/app/services/security_policy_service.py+++ b/backend/app/services/security_policy_service.py@@ -1,4 +1,4 @@-"""Panel security policy — the require-2FA enrollment policy (plan 29 Phase 2).+"""Panel security policy — the require-2FA enrollment policy.Evaluates, per user, whether the panel's *require two-factor* policy is satisfied,still within its grace window, or must be enforced now. The three outcomes are:@@ -8,12 +8,12 @@ still within its grace window, or must be enforced now. The three outcomes are:'enforce' — policy on, no 2FA, grace window elapsed → gate the sessionThe grace window is anchored on ``max(user.created_at, policy_enabled_at)`` so-flipping the policy ON never insta-locks a veteran account (plan 29 Decision 4).+flipping the policy ON never insta-locks a veteran account.``policy_enabled_at`` is stamped the moment the policy transitions off→on andlives in the same SettingsService map as the toggle itself — no new table.SSO accounts (``auth_provider`` other than ``local``) are exempt: their identity-provider owns the second factor (plan 29, security_policy_service ok/nudge/enforce+provider owns the second factor (security_policy_service ok/nudge/enforce+ SSO-exempt)."""from datetime import datetime, timedelta@@ -83,7 +83,7 @@ class SecurityPolicyService:"""The later of the account's creation and the policy's activation.Anchoring on the max means a long-lived account still gets the FULL grace- window when the policy is first switched on (plan 29 Decision 4)."""+ window when the policy is first switched on."""anchor = getattr(user, 'created_at', None) or datetime.utcnow()enabled_at = cls.policy_enabled_at()if enabled_at and enabled_at > anchor:diff --git a/backend/app/services/security_service.py b/backend/app/services/security_service.pyindex 34b13966..59f72c69 100644--- a/backend/app/services/security_service.py+++ b/backend/app/services/security_service.py@@ -6,8 +6,8 @@ security config, legacy file-integrity monitoring, suspicious-activity /event surfaces, SSH keys, IP allow/block lists, the security audit, and thescan/alert logs + notification helpers the extensions also write through.-The install-gated tools were extracted to installable extensions-(plan 47 Ph3b-4 / plan 55 Phase 3): ClamAV/YARA scanning and quarantine →+The install-gated tools were extracted to installable extensions:+ClamAV/YARA scanning and quarantine →serverkit-clamav, fail2ban management → serverkit-fail2ban (status probinglives on core ``Fail2banJailService``), Lynis → serverkit-lynis,unattended-upgrades → serverkit-auto-updates, container CVE/SBOM scanning →diff --git a/backend/app/services/service_connection_service.py b/backend/app/services/service_connection_service.pyindex 5b80108f..bbcfd5db 100644--- a/backend/app/services/service_connection_service.py+++ b/backend/app/services/service_connection_service.py@@ -1,4 +1,4 @@-"""Connection properties an installed service offers to other apps (plan 86 §C1).+"""Connection properties an installed service offers to other apps.``fromService`` used to resolve full connection details only for a``ManagedDatabase``. Any other sibling got a generic ``host``/``port``/``url``@@ -139,7 +139,7 @@ class ServiceConnectionService:'password': password})if protocol == 'postgresql' and getattr(app, 'pooler_enabled', False):- # Through the PgBouncer sidecar (plan 86 §D1); same credentials.+ # Through the PgBouncer sidecar; same credentials.from app.services.pooler_service import container_namepooled = _URL_PROTOCOLS['postgresql'].format(userinfo=userinfo, **dict(ctx, host=container_name(app), port='5432'))diff --git a/backend/app/services/setup_health_service.py b/backend/app/services/setup_health_service.pyindex f1622528..86595221 100644--- a/backend/app/services/setup_health_service.py+++ b/backend/app/services/setup_health_service.py@@ -1,4 +1,4 @@-"""Setup Health registry — "how set up is this panel" (plan 22).+"""Setup Health registry — "how set up is this panel".A small, cheap registry of setup-health *items* the operator should complete toget a fully-working panel. Each item is a doctor-style checkdiff --git a/backend/app/services/setup_reconcile_service.py b/backend/app/services/setup_reconcile_service.pyindex 95bab1be..36c3ab86 100644--- a/backend/app/services/setup_reconcile_service.py+++ b/backend/app/services/setup_reconcile_service.py@@ -1,4 +1,4 @@-"""Reconcile-on-connect (plan 22 Phase 3).+"""Reconcile-on-connect.When the operator finally connects a DNS provider / sets a server IP / picks abase domain, the sites they already created are still pointing at nothing. Thisdiff --git a/backend/app/services/signing_service.py b/backend/app/services/signing_service.pyindex b4fafd32..6af87b73 100644--- a/backend/app/services/signing_service.py+++ b/backend/app/services/signing_service.py@@ -1,4 +1,4 @@-"""Extension release signing — ed25519 detached signatures (plan 55, D3).+"""Extension release signing — ed25519 detached signatures.Signature format (minisign-style envelope, base64 of 74 bytes)::diff --git a/backend/app/services/site_domain_service.py b/backend/app/services/site_domain_service.pyindex 9012be1a..6a07f6a9 100644--- a/backend/app/services/site_domain_service.py+++ b/backend/app/services/site_domain_service.py@@ -557,7 +557,7 @@ class SiteDomainService:@classmethoddef set_immutable_assets(cls, app, enabled):"""Save the fingerprinted-asset caching flag and republish the vhost- through the same path as every other vhost setting (plan 86 §B2), so+ through the same path as every other vhost setting, sodrift detection renders the same file."""from app import dbapp.immutable_assets = bool(enabled)diff --git a/backend/app/services/site_import_service.py b/backend/app/services/site_import_service.pyindex d46af88f..2d79dbe1 100644--- a/backend/app/services/site_import_service.py+++ b/backend/app/services/site_import_service.py@@ -323,7 +323,7 @@ class SiteImportService:"""Stage a live site over SSH, then build the analyse report from thesource + pull result. Credentials never persist: the DB password isscrubbed from the durable source once the pull has consumed it, and the- staging manifest records no secrets (plan 31 #7/#9, Decision 5)."""+ staging manifest records no secrets."""from app.services.site_importers.ssh import GenericSshImporterimp.status = 'analyzing'diff --git a/backend/app/services/site_importers/ssh.py b/backend/app/services/site_importers/ssh.pyindex 292d80d3..3d21729b 100644--- a/backend/app/services/site_importers/ssh.py+++ b/backend/app/services/site_importers/ssh.py@@ -6,7 +6,7 @@ rsyncs the docroot and (optionally) dumps the site database into the importrun's work directory, then hands the standard pipeline a ready-to-copy``docroot/`` directory via the analysis' ``staged_docroot`` key.-Security posture (plan 31 Decision 5):+Security posture:* **Keyfile-only auth.** Authentication is by an SSH *key file on the panelhost* (``ssh -i``) under ``BatchMode=yes`` — no interactive password, no@@ -37,7 +37,7 @@ def parse_ssh_source(source):"""Validate + normalise an SSH import source into the durable spec.Required: ``host``, ``user``, ``docroot``. Auth is keyfile-only — any- ``password`` field is dropped (plan 31 #8). DB fields are carried through+ ``password`` field is dropped. DB fields are carried throughonly when present (they drive an optional remote dump). Raises:class:`ValueError` when a required field is missing."""@@ -211,7 +211,7 @@ class GenericSshImporter(BaseSiteImporter):@staticmethoddef _write_manifest(staging_dir, source, db_dump):"""Write a staging manifest recording ONLY non-secret facts — never the- DB password or the key material/path (plan 31 #9)."""+ DB password or the key material/path."""source = source or {}manifest = {'source_type': 'ssh',diff --git a/backend/app/services/slot_compose_service.py b/backend/app/services/slot_compose_service.pyindex 65ec36a0..45f4aa9d 100644--- a/backend/app/services/slot_compose_service.py+++ b/backend/app/services/slot_compose_service.py@@ -1,4 +1,4 @@-"""Slot deploys for compose apps (plan 87 §C).+"""Slot deploys for compose apps.Each slot is its own compose project, ``<name>-a`` / ``<name>-b``, renderedfrom the app's merged compose config (``docker compose config`` over the base@@ -259,7 +259,7 @@ def render_data(app, config: dict, web: str) -> dict:def write(path: str, rendered: dict) -> None:os.makedirs(os.path.dirname(path), exist_ok=True)with open(path, 'w', encoding='utf-8') as fh:- fh.write('# Rendered by ServerKit for A/B slot deploys (plan 87). Do not edit:\n'+ fh.write('# Rendered by ServerKit for A/B slot deploys. Do not edit:\n''# it is regenerated from the app\'s compose file on every deploy.\n')yaml.safe_dump(rendered, fh, sort_keys=False, default_flow_style=False)diff --git a/backend/app/services/slot_deploy_service.py b/backend/app/services/slot_deploy_service.pyindex b5644cd8..d502779d 100644--- a/backend/app/services/slot_deploy_service.py+++ b/backend/app/services/slot_deploy_service.py@@ -1,4 +1,4 @@-"""A/B slot deploys for apps (plan 87 §B).+"""A/B slot deploys for apps.The panel's own updater builds the new version into the idle slot while thelive one serves, flips a symlink, health-checks, and flips back if the checkdiff --git a/backend/app/services/slot_retention_service.py b/backend/app/services/slot_retention_service.pyindex b5bcaf76..ac081eb1 100644--- a/backend/app/services/slot_retention_service.py+++ b/backend/app/services/slot_retention_service.py@@ -1,5 +1,4 @@-"""Remove the previous version's install once the update has proven itself-(plan 85 §B1).+"""Remove the previous version's install once the update has proven itself.Updates install into the idle blue/green slot (``/opt/serverkit-a`` or``-b``) and flip the ``/opt/serverkit`` symlink, so the version that wasdiff --git a/backend/app/services/sso_service.py b/backend/app/services/sso_service.pyindex 7455c9ac..8a929b36 100644--- a/backend/app/services/sso_service.py+++ b/backend/app/services/sso_service.py@@ -38,7 +38,7 @@ PROVIDER_ENDPOINTS = {def _legacy_fernet():"""The pre-C2 Fernet (key derived from app SECRET_KEY) — read-only,- kept so tokens written before the fold-in still decrypt (plan 77 C2)."""+ kept so tokens written before the fold-in still decrypt."""key_bytes = current_app.config['SECRET_KEY'].encode('utf-8')digest = hashlib.sha256(key_bytes).digest()return Fernet(base64.urlsafe_b64encode(digest))diff --git a/backend/app/services/storage_overview_service.py b/backend/app/services/storage_overview_service.pyindex 57c85fe9..20b99d5f 100644--- a/backend/app/services/storage_overview_service.py+++ b/backend/app/services/storage_overview_service.py@@ -1,4 +1,4 @@-"""Where the panel host's disk goes (plan 85 §D1).+"""Where the panel host's disk goes.Read-only: measures, never deletes. Cleanup stays in``disk_reclaim_service`` (its safe candidates are what the Storage pagediff --git a/backend/app/services/storage_profile_service.py b/backend/app/services/storage_profile_service.pyindex 31885fdc..ec45cc86 100644--- a/backend/app/services/storage_profile_service.py+++ b/backend/app/services/storage_profile_service.py@@ -1,4 +1,4 @@-"""Size-aware storage defaults (plan 85 §C).+"""Size-aware storage defaults.A 25 GB VPS and a 500 GB server should not keep the same 30 days oftelemetry: on the small box ServerKit's own history competes with the appsdiff --git a/backend/app/services/support_bundle_service.py b/backend/app/services/support_bundle_service.pyindex fd7037a5..7e3c48e3 100644--- a/backend/app/services/support_bundle_service.py+++ b/backend/app/services/support_bundle_service.py@@ -157,7 +157,7 @@ def _collect_job_failures():def _collect_restore_confidence():- """Per-policy restore-proof summary (plan 23): last run + verify level, last+ """Per-policy restore-proof summary: last run + verify level, lastdrill age/status, cadence, offsite evidence level. Counts and states only —no paths, no secrets, matching the bundle's scrub discipline."""from datetime import datetimediff --git a/backend/app/services/survey_service.py b/backend/app/services/survey_service.pyindex 7005e475..bb24f27d 100644--- a/backend/app/services/survey_service.py+++ b/backend/app/services/survey_service.py@@ -1,4 +1,4 @@-"""Server survey service — read-only "flights" over a paired agent (plan 27).+"""Server survey service — read-only "flights" over a paired agent.Observe mode's heart is a *read-only survey*: the agent flies a declarativeprobe catalog against a paired Linux box and returns a structured payload; thediff --git a/backend/app/services/system_service.py b/backend/app/services/system_service.pyindex 7170046c..2d73b479 100644--- a/backend/app/services/system_service.py+++ b/backend/app/services/system_service.py@@ -117,7 +117,7 @@ class SystemService:def get_network_metrics(cls):"""Get network usage metrics.- Probe honesty (plan 75 §A3): mirrors the disk I/O block — when+ Probe honesty: mirrors the disk I/O block — whennet_io_counters/net_if_* fail or return nothing, the correspondingsection is None/empty rather than raising (which would kill the wholelive metrics broadcast) or fabricating zeros.diff --git a/backend/app/services/template_service.py b/backend/app/services/template_service.pyindex 5df7721d..e7d15167 100644--- a/backend/app/services/template_service.py+++ b/backend/app/services/template_service.py@@ -111,7 +111,7 @@ class TemplateService:'https://raw.githubusercontent.com/serverkit/templates',}- # Provider-owned templates (plan 52 D4 hook inversion): these ids are+ # Provider-owned templates (hook inversion): these ids are# listed and installable ONLY while the owning extension has registered as# their provider (i.e. it is installed + active this boot — registration# happens via the manifest ``core_hooks`` seam). The map itself is core;@@ -682,8 +682,8 @@ class TemplateService:# Whole-name magic tokens (no ``<NAME>`` suffix) -> internal kind. One# table so the resolver and the catalog validator agree on what exists.MAGIC_EXACT_TOKENS = {- 'SERVER_PUBLIC_IP': 'server_public_ip', # appliance tier (plan 35)- 'SERVERKIT_METRICS_TOKEN': 'metrics_token', # plan 86 §A4+ 'SERVER_PUBLIC_IP': 'server_public_ip', # appliance tier+ 'SERVERKIT_METRICS_TOKEN': 'metrics_token',}# Matches ``${SERVICE_...}`` magic tokens specifically (a subset of the@@ -1141,7 +1141,7 @@ class TemplateService:for app in apps:if app.port:used_ports.add(app.port)- # A slot app holds two ports (plan 87): the live one is app.port,+ # A slot app holds two ports: the live one is app.port,# the standby's stays reserved for the switch back.from app.models.app_slot import AppSlotused_ports.update(row.host_port for row in@@ -1216,7 +1216,7 @@ class TemplateService:disk" view, which ``build_repo_index`` needs to describe the bundlefaithfully for publishing. Provider-owned templates are hidden fromthe *catalog* instead — :meth:`list_all_templates` and- :meth:`get_template` apply the availability gate (plan 52 D4), so an+ :meth:`get_template` apply the availability gate, so anabsent extension means hidden cards and refused installs even thoughthe YAML remains bundled.@@ -1807,7 +1807,7 @@ class TemplateService:variables[var_name] = cls.generate_value(var_config)# Provider-owned templates validate through their provider's hook- # (plan 52 D4 — the WordPress external-DB preflight lives in the WP+ # (the WordPress external-DB preflight lives in the WP# extension now), never through hardcoded per-template branches here.veto = cls._run_provider_validate(template_id, variables)if veto:@@ -1946,7 +1946,7 @@ class TemplateService:variables[var_name] = cls.generate_value(var_config)# Validate provider-owned templates through their provider hook- # (plan 52 D4 — e.g. the external-DB connection preflight for+ # (e.g. the external-DB connection preflight for# wordpress-external-db is supplied by the WordPress extension).veto = cls._run_provider_validate(template_id, variables)if veto:@@ -2285,7 +2285,7 @@ class TemplateService:def _update_slot_app(cls, app, template, variables, install_info, info_path,compose_path, backup_path, compose_content, config, user_id,log_callback):- """Template update for a slot app (plan 87 §C): write the new compose,+ """Template update for a slot app: write the new compose,then deploy it into the idle slot. The live slot keeps serving untilthe new one passes its gate; any failure puts the old files back."""from app.services.deployment_service import DeploymentService@@ -2331,7 +2331,7 @@ class TemplateService:"""Update an installed app to the latest template version.The new compose is rendered, validated and its images resolved *before*- the running containers are stopped (plan 72 B.1) — a template whose new+ the running containers are stopped — a template whose newversion does not render, does not validate or cannot pull now failswith the old stack still serving."""diff --git a/backend/app/services/theme_registry_service.py b/backend/app/services/theme_registry_service.pyindex c1519d48..00fda105 100644--- a/backend/app/services/theme_registry_service.py+++ b/backend/app/services/theme_registry_service.py@@ -1,4 +1,4 @@-"""Remote theme registry (plan 60, Phase 3).+"""Remote theme registry.Mirrors the extension registry_service pattern, minus the trust machinery: atheme is data, not code, so there are no zips, no sha256, no permissions — the@@ -89,7 +89,7 @@ def _read_index_payload(payload, base_url=None):return [t for t in (_normalize(x, base_url) for x in themes) if t]-# One remote-catalog engine (plan 77 F1); this module stays a thin+# One remote-catalog engine; this module stays a thin# normalizer. The failure-retry semantics this service pioneered# (last-good served under full TTL, bundled held only error_ttl) now live# in CachedRemoteIndex for every catalog.diff --git a/backend/app/services/theme_service.py b/backend/app/services/theme_service.pyindex c42e0bfc..7099d51a 100644--- a/backend/app/services/theme_service.py+++ b/backend/app/services/theme_service.py@@ -1,4 +1,4 @@-"""Theme service (plan 60).+"""Theme service.Business logic for the themes platform: load the bundled seed themes, list /import / delete installed themes, resolve the panel-default theme (for pre-authdiff --git a/backend/app/services/theme_tokens.py b/backend/app/services/theme_tokens.pyindex 5ed34bd8..5b1e4a00 100644--- a/backend/app/services/theme_tokens.py+++ b/backend/app/services/theme_tokens.py@@ -1,6 +1,6 @@"""Canonical theme token whitelist + alias table + validators (server side).-A ServerKit theme is DATA, not code (plan 60): a map of canonical CSS+A ServerKit theme is DATA, not code: a map of canonical CSScustom-property names to values. This module is the backend source of truth forthe same three things the panel enforces client-side in``frontend/src/data/themeTokens.js`` — KEEP THE TWO IN SYNC:diff --git a/backend/app/services/unit_compose_service.py b/backend/app/services/unit_compose_service.pyindex fb98f0be..ba848f51 100644--- a/backend/app/services/unit_compose_service.py+++ b/backend/app/services/unit_compose_service.py@@ -1,4 +1,4 @@-"""Render a multi-container UNIT as one docker-compose project (plan 35, #8).+"""Render a multi-container UNIT as one docker-compose project.A unit is ONE manifest service with a ``containers:`` map. It becomes ONEApplication and ONE compose file: the project's implicit default network is thediff --git a/backend/app/services/uptime_service.py b/backend/app/services/uptime_service.pyindex afd1da96..3512a06b 100644--- a/backend/app/services/uptime_service.py+++ b/backend/app/services/uptime_service.py@@ -57,7 +57,7 @@ class UptimeService:def _save_history(cls, history: Dict) -> bool:"""Save uptime history to file. ``True`` when it was actually written.- Was ``except Exception: pass`` over a truncating write (plan 75 §G6):+ Was ``except Exception: pass`` over a truncating write:a full disk both destroyed the existing history and reported nothing,so the panel went on rendering an uptime figure computed from a filethat had stopped being updated. Now the write is atomic and the failurediff --git a/backend/app/services/volume_service.py b/backend/app/services/volume_service.pyindex d6bda979..f2d9ed50 100644--- a/backend/app/services/volume_service.py+++ b/backend/app/services/volume_service.py@@ -197,7 +197,7 @@ class VolumeService:"""Live host mountpoint for the app's volume at ``mount_path`` (or None).Used to route a manifest disk's backup at the real bytes rather than the- in-container path (plan 35)."""+ in-container path."""if app is None:return Nonevol = AppVolume.query.filter_by(diff --git a/backend/app/services/waf_service.py b/backend/app/services/waf_service.pyindex 30bb457a..1d81b284 100644--- a/backend/app/services/waf_service.py+++ b/backend/app/services/waf_service.py@@ -52,7 +52,7 @@ MODSEC_AUDIT_LOG = os.environ.get('SERVERKIT_MODSEC_AUDIT_LOG', '/var/log/modsec# Where managed app vhosts live. Imported, not mirrored: "mirrors# NginxService.SITES_AVAILABLE" is a comment, and a comment is not a-# constraint — the two drift the moment either side moves (plan 75 §G4).+# constraint — the two drift the moment either side moves.from app.services.nginx_service import NginxService # noqa: E402NGINX_CONF_DIR = NginxService.NGINX_CONF_DIR@@ -284,7 +284,7 @@ class WafService:@classmethoddef _write_file(cls, path: str, content: str) -> Dict:- """Write *content* to *path* with privilege — the shared door (plan 75 §G2)."""+ """Write *content* to *path* with privilege — the shared door."""from app.utils.system import write_privileged_filereturn write_privileged_file(path, content)@@ -409,8 +409,8 @@ class WafService:``write_app_vhost`` renders from the template, which has no WAFinclude; drift repair and a slot switch both rewrite the vhost, and- neither may strip protection the DB still records (plan 82 §F.1,- plan 87 §B). None when the app has no enforcing policy.+ neither may strip protection the DB still records. None when the app+ has no enforcing policy."""from app.models.waf_policy import WafPolicypolicy = WafPolicy.query.filter_by(application_id=application_id).first()diff --git a/backend/app/services/webhook_service.py b/backend/app/services/webhook_service.pyindex a517399e..f0802ac1 100644--- a/backend/app/services/webhook_service.py+++ b/backend/app/services/webhook_service.py@@ -493,7 +493,7 @@ class WebhookService:actions.append('deployed')log.status = 'processed'log.status_message = f'Deployed v{deployment_result.get("version")} ({log.commit_sha[:7] if log.commit_sha else "unknown"})'- # Push-to-reconfigure: re-read serverkit.yaml (plan 17 #17).+ # Push-to-reconfigure: re-read serverkit.yaml.try:from app.services.manifest_sync_service import ManifestSyncServiceManifestSyncService.resync_for_app(diff --git a/backend/app/services/wordpress_bridge.py b/backend/app/services/wordpress_bridge.pyindex a7d37238..8846d172 100644--- a/backend/app/services/wordpress_bridge.py+++ b/backend/app/services/wordpress_bridge.py@@ -1,6 +1,6 @@"""Importlib bridge to the ``serverkit-wordpress`` extension backend.-WordPress is a standalone extension (plan 52 Phase 5 — own repo, registry+WordPress is a standalone extension (own repo, registryinstall). Its backend loads as the *dashed* package``app.plugins.serverkit-wordpress``. Because the slug contains a dash it cannever be reached with a normal ``import`` statementdiff --git a/backend/app/services/worker_process_service.py b/backend/app/services/worker_process_service.pyindex 7efb4a8c..8e706252 100644--- a/backend/app/services/worker_process_service.py+++ b/backend/app/services/worker_process_service.py@@ -1,4 +1,4 @@-"""Procfile worker processes for build-pack apps (plan 86 §C3).+"""Procfile worker processes for build-pack apps.A build-pack deploy runs one container, ``serverkit-app-<id>``, from theimage it built, and only the Procfile ``web:`` line used to matter. Every other@@ -125,7 +125,7 @@ class WorkerProcessService:def connect_shared_network(app, container: str) -> None:"""Join a `docker run` container to the shared service network when the app- offers or uses a connectable service (plan 86 §C1). Compose apps get this+ offers or uses a connectable service. Compose apps get thisfrom their managed override; single-container apps get it here."""try:from app.services.docker_service import DockerServicediff --git a/backend/app/sockets.py b/backend/app/sockets.pyindex 479b9425..1b114198 100644--- a/backend/app/sockets.py+++ b/backend/app/sockets.py@@ -150,7 +150,7 @@ def _prune_audience(room=None):socketio.server.leave_room(sid, room, namespace='/')-# ==================== DECLARATIVE CHANNEL REGISTRY (plan 77 E2) ====================+# ==================== DECLARATIVE CHANNEL REGISTRY ====================## Eight hand-rolled subscribe/unsubscribe pairs used four different registry# shapes and re-checked auth inconsistently. register_channel() generates the@@ -514,7 +514,7 @@ def handle_leave_room(data):# ==================== DEPLOY CONSOLE STREAMING ====================#-# Live push for the Deploy Console (plan 51). Room is per DeploymentJob+# Live push for the Deploy Console. Room is per DeploymentJob# (`deploy_{job_id}`); the RunLogStream seam batches writes and emits one# `deploy_log` (a batch of persisted lines) per flush plus `deploy_status`# (the job summary dict) on step/terminal transitions. This is an ACCELERATOR@@ -569,7 +569,7 @@ def emit_deploy_status(job_id: str, status: dict):}, room=rooms.deploy_room(job_id))-# ==================== GENERALIZED RUN ENVELOPE (plan 77 E1) ====================+# ==================== GENERALIZED RUN ENVELOPE ====================## One event pair for every run kind, keyed by (run_kind, run_id) in the room# run_<kind>_<id>. The deploy kind dual-emits the legacy deploy_log /diff --git a/backend/app/sockets_rooms.py b/backend/app/sockets_rooms.pyindex f686cce3..dd010791 100644--- a/backend/app/sockets_rooms.py+++ b/backend/app/sockets_rooms.py@@ -1,4 +1,4 @@-"""Every Socket.IO room name is built HERE (plan 77 E3).+"""Every Socket.IO room name is built HERE.The room grammar used to live in ~25 scattered f-strings across sockets.py,agent_gateway.py and the notification bus — and was re-derived by hand in@@ -11,7 +11,7 @@ Grammar:user_<user_id> per-user notification fan-outdeploy_<job_id> Deploy Console (legacy run envelope)- run_<kind>_<run_id> generalized run envelope (plan 77 E1)+ run_<kind>_<run_id> generalized run envelopelogs_<app_id> container log streaming for an appserver_<id>_<channel> generic agent-stream rebroadcastserver_<id>_metrics agent metrics fan-out@@ -29,7 +29,7 @@ def deploy_room(job_id) -> str:def run_room(run_kind, run_id) -> str:- """The plan 77 E1 run envelope room — one grammar for every run kind."""+ """The run envelope room — one grammar for every run kind."""return f'run_{run_kind}_{run_id}'diff --git a/backend/app/utils/background_loop.py b/backend/app/utils/background_loop.pyindex 7ba76d57..bb724c7b 100644--- a/backend/app/utils/background_loop.py+++ b/backend/app/utils/background_loop.py@@ -1,4 +1,4 @@-"""BackgroundLoop — the one shape for process-lifetime polling loops (plan 77 E5).+"""BackgroundLoop — the one shape for process-lifetime polling loops.The 13 LIFECYCLE_PROCESS_LOOP threads each hand-rolled the same dance: abool flag (or Event), a daemon Thread, a try/except around the tick (somediff --git a/backend/app/utils/config_store.py b/backend/app/utils/config_store.pyindex cd75f6de..449279bf 100644--- a/backend/app/utils/config_store.py+++ b/backend/app/utils/config_store.py@@ -1,5 +1,5 @@"""JSON-file config persistence — one door for the load-or-default /-dump-or-error mechanics (plan 75 §F4).+dump-or-error mechanics.Five services shipped byte-identical ``save_config`` copies and seven more thesame ``get_config`` skeleton, each a place a fix (an atomic write, a better@@ -8,7 +8,7 @@ the per-service parts stay per-service: the path, the default, and any extrabehaviour around the write (cache invalidation, secret merging — those keeptheir own methods and may call these helpers inside).-The write is atomic (plan 75 §G6). The consolidation that created this module+The write is atomic. The consolidation that created this moduledeliberately kept the copies' plain ``open(..., 'w')`` so that no behaviourchange rode along with it, and noted that atomic writes, if ever wanted, wouldland here once. This is that once: a truncating write that dies mid-``json.dump``diff --git a/backend/app/utils/env.py b/backend/app/utils/env.pyindex f85b25ac..c1e5c575 100644--- a/backend/app/utils/env.py+++ b/backend/app/utils/env.py@@ -1,4 +1,4 @@-"""One door for call-time environment access (plan 77 F4).+"""One door for call-time environment access.Boolean env parsing existed in three incompatible variants across the app —`('1', 'true', 'yes', 'on')` in config.py, `('1', 'true', 'yes')` indiff --git a/backend/app/utils/formatting.py b/backend/app/utils/formatting.pyindex 9d0af798..a9d66fdd 100644--- a/backend/app/utils/formatting.py+++ b/backend/app/utils/formatting.py@@ -44,7 +44,7 @@ def format_size(num_bytes):Lives here rather than in a service because capacity_service andhost_inventory_service both need it, and this module imports nothing — theduplicate that prompted this was written to dodge an import cycle that- cannot exist (plan 75 §F1).+ cannot exist."""if num_bytes is None:return 'unknown'diff --git a/backend/app/utils/i18n.py b/backend/app/utils/i18n.pyindex 655e9108..474da7f2 100644--- a/backend/app/utils/i18n.py+++ b/backend/app/utils/i18n.py@@ -1,4 +1,4 @@-"""Supported UI languages (plan 79 B2).+"""Supported UI languages.The **canonical** list is the frontend manifest,``frontend/src/i18n/languages.json`` — that is what the browser actually loadsdiff --git a/backend/app/utils/remote_index.py b/backend/app/utils/remote_index.pyindex d7fdd2b7..f924151c 100644--- a/backend/app/utils/remote_index.py+++ b/backend/app/utils/remote_index.py@@ -1,4 +1,4 @@-"""CachedRemoteIndex — the one remote-catalog engine (plan 77 F1).+"""CachedRemoteIndex — the one remote-catalog engine.The fetch → TTL cache → last-good fallback → bundled-file fallback pipelinewas re-implemented per catalog (extension registry, theme registry, …) anddiff --git a/backend/app/utils/sdk.py b/backend/app/utils/sdk.pyindex c6a6d79b..f905c220 100644--- a/backend/app/utils/sdk.py+++ b/backend/app/utils/sdk.py@@ -34,13 +34,13 @@ from app.utils.version import compare_versions# 1.6.0 — one field per job: ServerPicker, DomainField + attachDomain,# PortField, EnvEditor, CopyField/CopyButton, InfoList, CatalogCard/Grid.# 1.5.0 — declarative walkthrough authoring helpers and useWalkthroughs.-# 1.3.0 — plan 79: localization. useTranslation/Trans/t, useLocale, useLabel,+# 1.3.0 — localization. useTranslation/Trans/t, useLocale, useLabel,# and the locale-aware format door (useFormat + formatDate/Number/Relative/…).# i18next and react-i18next also became SHARED vendor singletons, so an# extension that externalizes them needs a panel at this SDK or newer:# pin `"sdk_version": "^1.3.0"` if you use any of that surface.# Additive — an extension pinned to ^1.2.0 keeps loading.-# 1.2.0 — plan 52 Phases 4-5: layout/feedback primitives, ui/* form kit,+# 1.2.0 — layout/feedback primitives, ui/* form kit,# common hooks, format utils, and the cross-feature embeds (git repo-connect,# backups ProtectionPanel) the WordPress runtime-ESM extraction needed.SDK_VERSION = '1.6.0'diff --git a/backend/app/utils/sensitive_data_filter.py b/backend/app/utils/sensitive_data_filter.pyindex 92a80f0e..d8c8918a 100644--- a/backend/app/utils/sensitive_data_filter.py+++ b/backend/app/utils/sensitive_data_filter.py@@ -22,8 +22,8 @@ MASK = '••••••••'REVEAL_SCOPE = 'secrets:read'# Substrings that mark a dict key as sensitive. Matched case-insensitively-# against the key name. THE union of every sink's former private list-# (plan 77 F3): response filter, audit_service, middleware/audit (the only+# against the key name. THE union of every sink's former private list:+# response filter, audit_service, middleware/audit (the only# one that covered totp/otp/csrf/session), telemetry. A keyword added here# is redacted by ALL sinks; adding one to a single sink again is ratcheted# by tests/test_redaction_one_door.py.diff --git a/backend/app/utils/slug.py b/backend/app/utils/slug.pyindex 1a7db5b5..33058736 100644--- a/backend/app/utils/slug.py+++ b/backend/app/utils/slug.py@@ -36,7 +36,7 @@ def unique_slug(base, exists, default='untitled', start=1):default: Fallback string when `base` slugifies to something empty.start: First suffix to try. `saved_view_service` numbered itsduplicates from 2 and kept a private copy of this loop for that one- difference (plan 75 §G6); a parameter is cheaper than a second+ difference; a parameter is cheaper than a secondimplementation, and changing its numbering would have renamedhandles users already had.diff --git a/backend/app/utils/system.py b/backend/app/utils/system.pyindex 5664150c..d1de5176 100644--- a/backend/app/utils/system.py+++ b/backend/app/utils/system.py@@ -166,14 +166,14 @@ def run_checked(cmd: Union[List[str], str], *, privileged: bool = False,timeout: Optional[int] = 60, input: Optional[str] = None,cwd: Optional[str] = None, env: Optional[dict] = None,merge_stderr: bool = False, **kwargs) -> dict:- """Run a command and get a result, not a ``CompletedProcess`` (plan 75 §G1).+ """Run a command and get a result, not a ``CompletedProcess``.The result-shaped door. Around ``backend/app``'s raw ``subprocess`` callssit 220 copies of ``capture_output=True, text=True``, 56 hand-rolled``except subprocess.TimeoutExpired`` handlers, 19 hand-rolled``except FileNotFoundError`` handlers, and 1,164 literal``{'success': False, 'error': ...}`` constructions. Each of those is a- place where an exec failure can be — and per plan 74 has been — converted+ place where an exec failure can be — and has been — convertedinto a false fact about the operator's server.Returns::@@ -375,14 +375,14 @@ def run_from_gzip(cmd: List[str], src: str, *, env: Optional[dict] = None,def write_privileged_file(path: str, content: str, *, append: bool = False,mode: Optional[str] = None,owner: Optional[str] = None) -> dict:- """Write *content* to *path* with privilege escalation. One door (plan 75 §G2).+ """Write *content* to *path* with privilege escalation. One door.The write-a-root-owned-file sequence was pasted at 15+ call sites in **twocompeting forms**: ``run_privileged(['tee', path], input=content)`` and araw ``subprocess.run(['sudo', 'tee', path], ...)``. The second form is thedrift this plan exists to remove — it hardcodes ``sudo`` instead of asking:func:`_needs_sudo`, so it fails on a panel already running as root (no- sudo binary in a minimal container) exactly the way plan 74's outage did.+ sudo binary in a minimal container) exactly the way a past outage did.Returns a result dict rather than a ``CompletedProcess`` because every oneof those call sites immediately converted one into the other:@@ -448,7 +448,7 @@ def unit_is_active(unit: str, *, timeout: int = 10) -> Optional[bool]:that timed out — and is deliberately not ``False``. The five hand-rolledcopies of this ``systemctl is-active`` call all collapsed those cases into"not running", which is how a working service gets reported as down on a- host the panel simply could not ask (plan 74's outage, one layer up).+ host the panel simply could not ask (the same outage, one layer up).Callers that genuinely want two states write ``unit_is_active(u) is True``and are then saying so out loud.@@ -641,7 +641,7 @@ class ServiceControl:The translation was re-implemented per service with subtly divergentfailure shapes ('error' vs 'message' carrying stderr); keep the keyand fallback parametrized so converting a site is parity, not a- contract change (plan 75 §F5).+ contract change."""if proc.returncode == 0:return {'success': True, 'message': ok_message}diff --git a/backend/tests/test_nginx_timed_log.py b/backend/tests/test_nginx_timed_log.pyindex 17fd4b22..6fd5e4cb 100644--- a/backend/tests/test_nginx_timed_log.py+++ b/backend/tests/test_nginx_timed_log.py@@ -128,3 +128,17 @@ def test_drift_leaves_a_hand_edited_access_log_alone(tmp_path):def test_drift_reports_a_missing_file_as_none(tmp_path):missing = str(tmp_path / 'nope')assert _nginx_read_actual([missing]) == {missing: None}+++def test_drift_reads_the_old_asset_comment_as_the_current_one(tmp_path):+ """The comment above the immutable-asset block lost an internal reference;+ an existing vhost that still carries it is not drifted."""+ rendered = NginxService._with_immutable_assets(+ 'server {\n location / {\n proxy_pass http://127.0.0.1:8003;\n }\n}\n',+ 'docker')+ old = rendered.replace('fingerprinted assets never change\n',+ 'fingerprinted assets never change (old ref §B2)\n')+ assert old != rendered+ vhost = tmp_path / 'shop'+ vhost.write_text(old)+ assert _nginx_read_actual([str(vhost)])[str(vhost)] == rendereddiff --git a/backend/tests/test_no_plan_references.py b/backend/tests/test_no_plan_references.pynew file mode 100644index 00000000..5c0e2ecf--- /dev/null+++ b/backend/tests/test_no_plan_references.py@@ -0,0 +1,54 @@+"""App code must not cite internal plan numbers.++Plans live in a git-ignored folder, so "(plan 29 #9)" in a comment points+at nothing for anyone but its author — 680 of them had piled up, and one+reached users in a bottleneck hint. Say what the code does and why; the+history belongs in the commit message.+"""+import re+import subprocess+from pathlib import Path++REPO = Path(__file__).resolve().parents[2]+ROOTS = ['backend/app', 'frontend/src', 'builtin-extensions']+PLAN_REF = re.compile(r'\bplan[- ]?\d{2}\b', re.IGNORECASE)++# A vendored, signed registry index: its text is not ours to edit.+EXCLUDED = {'backend/app/data/registry_index.json'}+# Files with references still to remove, at their current count. The count+# may only go down; delete an entry once its file is clean.+PENDING = {+ 'backend/app/services/deployment_job_service.py': 4,+}+++def _tracked():+ out = subprocess.run(['git', 'ls-files', '-z', '--', *ROOTS], cwd=REPO,+ capture_output=True, check=True).stdout+ return [p for p in out.decode().split('\0') if p and p not in EXCLUDED]+++def _counts():+ found = {}+ for rel in _tracked():+ try:+ text = (REPO / rel).read_text(encoding='utf-8')+ except (UnicodeDecodeError, FileNotFoundError):+ continue+ hits = len(PLAN_REF.findall(text))+ if hits:+ found[rel] = hits+ return found+++def test_no_plan_number_references_in_app_code():+ over = {rel: n for rel, n in _counts().items() if n > PENDING.get(rel, 0)}+ assert not over, (+ 'Internal plan numbers in app code (the plans are not in the repo): '+ + ', '.join(f'{rel} ({n})' for rel, n in sorted(over.items())))+++def test_pending_list_is_not_stale():+ counts = _counts()+ stale = {rel: n for rel, n in PENDING.items() if counts.get(rel, 0) < n}+ assert not stale, f'Lower or remove these PENDING entries: {stale} (now {counts})'diff --git a/builtin-extensions/serverkit-cloud-provision/backend/__init__.py b/builtin-extensions/serverkit-cloud-provision/backend/__init__.pyindex 8d59cc3c..c8832fc6 100644--- a/builtin-extensions/serverkit-cloud-provision/backend/__init__.py+++ b/builtin-extensions/serverkit-cloud-provision/backend/__init__.py@@ -1,6 +1,6 @@"""ServerKit Cloud Provisioning extension backend package.-Extracted from core (plan 47): the cloud-provider blueprint + service ship here+Extracted from core: the cloud-provider blueprint + service ship hereso a fresh panel that never provisions cloud servers loads none of it. Mountedunder ``/api/v1/cloud`` via the manifest's ``url_prefix``. The CloudProvider /CloudServer models stay in core (G2); this package imports them. Upgradesdiff --git a/builtin-extensions/serverkit-ftp/backend/__init__.py b/builtin-extensions/serverkit-ftp/backend/__init__.pyindex a4514248..d655d1dc 100644--- a/builtin-extensions/serverkit-ftp/backend/__init__.py+++ b/builtin-extensions/serverkit-ftp/backend/__init__.py@@ -1,6 +1,6 @@"""ServerKit FTP extension backend package.-Extracted from core (plan 47): the FTP blueprint + service ship here so a fresh+Extracted from core: the FTP blueprint + service ship here so a freshpanel that never touches FTP loads none of it. Mounted under ``/api/v1/ftp`` viathe manifest's ``url_prefix``; upgrades re-acquire it automatically(``CONVERTED_BUILTIN_SLUGS``).diff --git a/builtin-extensions/serverkit-remote-access/backend/__init__.py b/builtin-extensions/serverkit-remote-access/backend/__init__.pyindex f766423c..04e00ad2 100644--- a/builtin-extensions/serverkit-remote-access/backend/__init__.py+++ b/builtin-extensions/serverkit-remote-access/backend/__init__.py@@ -1,6 +1,6 @@"""ServerKit Remote Access extension backend package (WireGuard tunnels).-Extracted from core (plan 47): the tunnels blueprint + broker/publish/netutil+Extracted from core: the tunnels blueprint + broker/publish/netutilservices ship here so a fresh panel that never exposes a NAT'd service loads noneof it. Mounted under ``/api/v1/tunnels`` via the manifest's ``url_prefix``. TheTunnel / ExposedService models stay in core (G2); this package imports them.diff --git a/builtin-extensions/serverkit-status/backend/__init__.py b/builtin-extensions/serverkit-status/backend/__init__.pyindex 5087b60e..f04248b0 100644--- a/builtin-extensions/serverkit-status/backend/__init__.py+++ b/builtin-extensions/serverkit-status/backend/__init__.py@@ -1,6 +1,6 @@"""ServerKit Status Pages extension backend package.-Extracted from core (plan 47): the status-pages blueprint (public status/badge+Extracted from core: the status-pages blueprint (public status/badgeroutes + authenticated management API) and its service ship here so a fresh panelthat never publishes a status page loads none of it. Mounted under``/api/v1/status`` via the manifest's ``url_prefix``; the public /status/<slug>diff --git a/frontend/src/App.jsx b/frontend/src/App.jsxindex 6fd24da3..fb4773c7 100644--- a/frontend/src/App.jsx+++ b/frontend/src/App.jsx@@ -250,7 +250,7 @@ function App() {return (<Router basename={TUNNEL_BASE || undefined}>{/* Outermost: a toast raised while the theme or workspace is still- initialising must already be translatable (plan 79 B1). */}+ initialising must already be translatable. */}<LocaleProvider><WorkspaceProvider><ThemeProvider>diff --git a/frontend/src/components/CommandPalette.jsx b/frontend/src/components/CommandPalette.jsxindex 1c1871aa..3fe0a0f1 100644--- a/frontend/src/components/CommandPalette.jsx+++ b/frontend/src/components/CommandPalette.jsx@@ -75,7 +75,7 @@ const TYPE_LABEL = {workspace: 'Workspace', project: 'Project', domain: 'Domain',};-// Docs entries derived from the single docsLinks map (plan 40). Hidden under+// Docs entries derived from the single docsLinks map. Hidden under// White Label since they point at the public serverkit.ai docs.const DOCS_ENTRIES = [{ key: 'deploySources', labelKey: 'palette.docs.deploySources', label: 'Docs: Deploy sources', keywords: 'deploy source repo git' },diff --git a/frontend/src/components/LocaleSync.jsx b/frontend/src/components/LocaleSync.jsxindex e3ffdbf1..cf9a5b08 100644--- a/frontend/src/components/LocaleSync.jsx+++ b/frontend/src/components/LocaleSync.jsx@@ -3,7 +3,7 @@ import { useAuth } from '../contexts/useAuth.js';import { useLocale } from '../contexts/useLocale.js';import api from '../services/api';-// Bridges auth -> locale (plan 79 B1/B2). LocaleProvider sits above+// Bridges auth -> locale. LocaleProvider sits above// AuthProvider so the sign-in screen is translated before anyone is signed in,// which means it cannot read auth state itself. This renders inside// AuthProvider and does two things:diff --git a/frontend/src/components/ManagedCard.jsx b/frontend/src/components/ManagedCard.jsxindex 1ff93b74..9a0c1721 100644--- a/frontend/src/components/ManagedCard.jsx+++ b/frontend/src/components/ManagedCard.jsx@@ -3,7 +3,7 @@ import { useTranslation } from 'react-i18next';import useLabel from '../i18n/labels';import { MANAGED_CAPABILITY_MAP } from './sidebarItems';-// The managed card (plan 25): what a held capability's page shows instead of+// The managed card: what a held capability's page shows instead of// its content. It names the capability, who holds it and since when, and links// to the server's page in ServerKit Cloud through the support URL the signed// policy carried. It never claims the page is gone — hidden is not removed:diff --git a/frontend/src/components/Modal.jsx b/frontend/src/components/Modal.jsxindex 6ea568ec..0aa5737a 100644--- a/frontend/src/components/Modal.jsx+++ b/frontend/src/components/Modal.jsx@@ -5,7 +5,7 @@ import { cn } from '@/lib/utils';// (styles/components/_ui.scss → .sk-modal*). `size` picks a max-width on// >=sm screens; mobile is always near full-width.//-// Form mode (plan 79 G2 / plan 76 F2): pass `onSubmit` and the body AND footer+// Form mode: pass `onSubmit` and the body AND footer// are wrapped in one <form>. This exists because a submit button must live// inside the form it submits — without it, every modal with a form had to// bypass `footer` and hand-roll its own footer row inside the body, which isdiff --git a/frontend/src/components/Sidebar.jsx b/frontend/src/components/Sidebar.jsxindex 21958cd9..1cc23df2 100644--- a/frontend/src/components/Sidebar.jsx+++ b/frontend/src/components/Sidebar.jsx@@ -145,7 +145,7 @@ const Sidebar = ({ mobileOpen = false, isMobile = false, onMobileClose = () => {// Developer-only items (Test Sandbox) — same source the route guard reads.const devMode = useDevMode();- // Sidebar items ServerKit Cloud holds under the managed profile (plan 25).+ // Sidebar items ServerKit Cloud holds under the managed profile.const { hiddenSidebarIds: managedHidden } = useManagedProfile();const conditions = { wpInstalled, gpuAvailable, wordpressEnabled, devMode };@@ -205,7 +205,7 @@ const Sidebar = ({ mobileOpen = false, isMobile = false, onMobileClose = () => {// and it defines a nav map. This lets a workspace restrict which sidebar// items its members see based on their effective workspace role.items = applyWorkspaceNavPermissions(items, activeWorkspace, user);- // The managed profile (plan 25): capabilities ServerKit Cloud holds+ // The managed profile: capabilities ServerKit Cloud holds// remove their sidebar items from every preset, the same way a// workspace nav map removes them.if (managedHidden.size > 0) {diff --git a/frontend/src/components/StagingBanner.jsx b/frontend/src/components/StagingBanner.jsxindex a6035be9..a7cde8a1 100644--- a/frontend/src/components/StagingBanner.jsx+++ b/frontend/src/components/StagingBanner.jsx@@ -3,7 +3,7 @@ import api from '../services/api';import { useTranslation } from 'react-i18next';/**- * STAGING banner — a full-width amber strip shown only on the plan-37 staging+ * STAGING banner — a full-width amber strip shown only on the staging* testbed. Driven by the public /system/health endpoint echoing `staging:true`* (set via the SERVERKIT_STAGING env var on the staging instance). Renders* nothing on a normal instance and never throws on fetch errors.diff --git a/frontend/src/components/StatusBadge.jsx b/frontend/src/components/StatusBadge.jsxindex ef1e8afe..a81266f8 100644--- a/frontend/src/components/StatusBadge.jsx+++ b/frontend/src/components/StatusBadge.jsx@@ -2,7 +2,7 @@ import { Badge } from '@/components/ui/badge';import { cn } from '@/lib/utils';import { serviceStatusVariant, serviceStatusDotClass, statusLabel } from '@/components/ds/status';-// One vocabulary (plan 77 D3): variant, dot color and label all derive from+// One vocabulary: variant, dot color and label all derive from// ds/status.js — service-scoped, so "running" stays the healthy green.export default function StatusBadge({ status, label, className = '' }) {diff --git a/frontend/src/components/ThemeSync.jsx b/frontend/src/components/ThemeSync.jsxindex 12fd8c3d..bafea354 100644--- a/frontend/src/components/ThemeSync.jsx+++ b/frontend/src/components/ThemeSync.jsx@@ -3,7 +3,7 @@ import { useAuth } from '../contexts/useAuth.js';import { useTheme } from '../contexts/useTheme.js';import api from '../services/api';-// Bridges auth → theme (plan 60). ThemeProvider sits above AuthProvider, so it+// Bridges auth → theme. ThemeProvider sits above AuthProvider, so it// can't read auth state itself; this renders inside AuthProvider and, once the// user is signed in, loads the installed (registry/imported) themes and merges// them into the gallery. Renders nothing.diff --git a/frontend/src/components/appdetail/SettingsTab.jsx b/frontend/src/components/appdetail/SettingsTab.jsxindex bd8e638c..a50edfd1 100644--- a/frontend/src/components/appdetail/SettingsTab.jsx+++ b/frontend/src/components/appdetail/SettingsTab.jsx@@ -27,7 +27,7 @@ const SettingsTab = ({ app, onUpdate }) => {async function handleDelete() {// Surface the schedules this delete will strand (kept but detached) so the- // operator decides with eyes open — the honest-delete half of plan 34 #3.+ // operator decides with eyes open — the honest-delete half of cron completion.let cronNote = '';try {const jobs = (await api.getCronJobsForApp(app.id))?.jobs || [];diff --git a/frontend/src/components/apps/DeploySafetyPanel.jsx b/frontend/src/components/apps/DeploySafetyPanel.jsxindex 32b88962..16a62958 100644--- a/frontend/src/components/apps/DeploySafetyPanel.jsx+++ b/frontend/src/components/apps/DeploySafetyPanel.jsx@@ -13,7 +13,7 @@ const TIMEOUT_DEFAULT = 120;const TIMEOUT_MIN = 5;const TIMEOUT_MAX = 1800;-// Health gate settings (plan 87 §A4). A deploy waits for the new release to+// Health gate settings. A deploy waits for the new release to// answer its health path before it counts as live; these say where to ask and// how long to wait.const DeploySafetyPanel = ({ app, onChanged }) => {diff --git a/frontend/src/components/apps/MicroCachePanel.jsx b/frontend/src/components/apps/MicroCachePanel.jsxindex a6ecb12f..638a5959 100644--- a/frontend/src/components/apps/MicroCachePanel.jsx+++ b/frontend/src/components/apps/MicroCachePanel.jsx@@ -17,7 +17,7 @@ const TTL_MAX = 300;// asset rule applies to (NginxService._with_immutable_assets).const PROXIED_TYPES = ['docker', 'flask', 'django', 'python', 'remote'];-// Micro-cache panel (task #21, plan 86 §B3) — opt-in nginx page cache per+// Micro-cache panel — opt-in nginx page cache per// site. The backend rewrites the site's vhost with the cache directives plus// hard bypasses for anything personalized (logged-in cookies, carts,// admin/login paths, non-GET requests, query strings). Stale copies are serveddiff --git a/frontend/src/components/apps/SlotDeploysPanel.jsx b/frontend/src/components/apps/SlotDeploysPanel.jsxindex 17c0d009..37728511 100644--- a/frontend/src/components/apps/SlotDeploysPanel.jsx+++ b/frontend/src/components/apps/SlotDeploysPanel.jsx@@ -20,7 +20,7 @@ function intIn(value, min, max) {return Number.isInteger(n) && n >= min && n <= max ? n : null;}-// A/B slot deploys (plan 87 §F): the opt-in and its knobs. Eligibility comes+// A/B slot deploys: the opt-in and its knobs. Eligibility comes// from the server with its reasons, so the toggle never promises what a// deploy would then refuse.const SlotDeploysPanel = ({ app, onChanged }) => {diff --git a/frontend/src/components/backups/ProtectionPanel.jsx b/frontend/src/components/backups/ProtectionPanel.jsxindex e254be48..f7463ae5 100644--- a/frontend/src/components/backups/ProtectionPanel.jsx+++ b/frontend/src/components/backups/ProtectionPanel.jsx@@ -47,7 +47,7 @@ export default function ProtectionPanel({ targetType, targetId, targetName, showconst [detailRun, setDetailRun] = useState(null);const [restoreRun, setRestoreRun] = useState(null);// Restore scopes this target type supports, from the target-types API- // (extension-provided types declare their own — plan 52 D4). Null until+ // (extension-provided types declare their own). Null until// loaded; RestoreDrawer falls back to its built-in defaults then.const [restoreScopes, setRestoreScopes] = useState(null);const reloadTimers = useRef([]);diff --git a/frontend/src/components/backups/RestoreDrawer.jsx b/frontend/src/components/backups/RestoreDrawer.jsxindex 5a67de8b..f218b974 100644--- a/frontend/src/components/backups/RestoreDrawer.jsx+++ b/frontend/src/components/backups/RestoreDrawer.jsx@@ -35,7 +35,7 @@ const BASE_SCOPE_OPTIONS = [{ value: 'files', labelKey: 'app.restoreDrawer.filesOnly', label: 'Files only' },];-// Labels for provider-declared restore scopes (plan 52 D4): extension backup+// Labels for provider-declared restore scopes: extension backup// kinds tell the panel which scopes they support via /backups/target-types,// so the drawer no longer hardcodes which type owns which scope.const SCOPE_LABELS = {diff --git a/frontend/src/components/backups/format.js b/frontend/src/components/backups/format.jsindex 0370b0c9..87ffe100 100644--- a/frontend/src/components/backups/format.js+++ b/frontend/src/components/backups/format.js@@ -44,7 +44,7 @@ export function formatDateTime(iso) {});}-// Pill kind for a run/policy status, from the ONE shared vocabulary (plan 77 D3).+// Pill kind for a run/policy status, from the ONE shared vocabulary.export { statusKind } from '../ds/status';// Where a run is stored, from its size/remote fields.diff --git a/frontend/src/components/dashboard/AccountSecurityNudge.jsx b/frontend/src/components/dashboard/AccountSecurityNudge.jsxindex 15ba6651..0f5fd9cb 100644--- a/frontend/src/components/dashboard/AccountSecurityNudge.jsx+++ b/frontend/src/components/dashboard/AccountSecurityNudge.jsx@@ -5,10 +5,10 @@ import { Button } from '@/components/ui/button';import { ShieldAlert, X } from 'lucide-react';import { useTranslation } from 'react-i18next';-// Per-user "secure your account" nudge (plan 22 #12). Shows when the requesting+// Per-user "secure your account" nudge. Shows when the requesting// user has no second factor, deep-linking to Settings → Security where the full// guided enrolment lives (passkey-first, then TOTP with its QR). Dismissible;-// the dismissal is persisted to the account's `setup_snoozes` (plan 29 #8) so it+// the dismissal is persisted to the account's `setup_snoozes` so it// follows the user across browsers, with localStorage kept only as a fast cache// so the nudge doesn't flash before the account fetch resolves.diff --git a/frontend/src/components/dashboard/widgets/metrics.js b/frontend/src/components/dashboard/widgets/metrics.jsindex 30691081..543fa7b0 100644--- a/frontend/src/components/dashboard/widgets/metrics.js+++ b/frontend/src/components/dashboard/widgets/metrics.js@@ -1,5 +1,5 @@/**- * Metric catalog for the dashboard widget grid (plan 62).+ * Metric catalog for the dashboard widget grid.** Every entry here is backed by a REAL field on a real payload — there is no* synthetic data anywhere in the widget stack. Two history payloads exist anddiff --git a/frontend/src/components/dashboard/widgets/registry.js b/frontend/src/components/dashboard/widgets/registry.jsindex 77e2dcb8..23afc52c 100644--- a/frontend/src/components/dashboard/widgets/registry.js+++ b/frontend/src/components/dashboard/widgets/registry.js@@ -1,5 +1,5 @@/**- * Widget type registry for the dashboard grid (plan 62).+ * Widget type registry for the dashboard grid.** A widget TYPE describes a placeable kind of widget:* { id, name, icon, cat, desc, w, h, min: [w,h], defaultCfg, component?, plugin? }diff --git a/frontend/src/components/dashboard/widgets/renderers.jsx b/frontend/src/components/dashboard/widgets/renderers.jsxindex 0ab15762..5e4962de 100644--- a/frontend/src/components/dashboard/widgets/renderers.jsx+++ b/frontend/src/components/dashboard/widgets/renderers.jsx@@ -2,7 +2,7 @@ import { statusColor } from '@/components/ds/status';import { Button } from '@/components/ui/button';import { formatRelativeTime } from '@/utils/time';/**- * The 13 core dashboard widget renderers (plan 62).+ * The 13 core dashboard widget renderers.** Every renderer is presentational — all fetching lives in ./useWidgetData.* Every renderer handles three states: loading, empty and error. Nothing herediff --git a/frontend/src/components/dashboard/widgets/useWidgetData.js b/frontend/src/components/dashboard/widgets/useWidgetData.jsindex 96480d94..3fea3b43 100644--- a/frontend/src/components/dashboard/widgets/useWidgetData.js+++ b/frontend/src/components/dashboard/widgets/useWidgetData.js@@ -1,5 +1,5 @@/**- * Data hooks shared by the dashboard widget renderers (plan 62).+ * Data hooks shared by the dashboard widget renderers.** Renderers stay presentational: everything that talks to the API lives here.*diff --git a/frontend/src/components/databases/InsightsPanel.jsx b/frontend/src/components/databases/InsightsPanel.jsxindex 42d71fb6..37bbfcdc 100644--- a/frontend/src/components/databases/InsightsPanel.jsx+++ b/frontend/src/components/databases/InsightsPanel.jsx@@ -17,8 +17,8 @@ function formatMs(ms) {: `${formatNumber(ms, { maximumFractionDigits: 1 })} ms`;}-// Top queries + connection / cache-hit gauges for a Docker database container-// (plan 86 §A3). Read-only, except the one switch PostgreSQL needs before it+// Top queries + connection / cache-hit gauges for a Docker database container.+// Read-only, except the one switch PostgreSQL needs before it// records statements: pg_stat_statements, applied through the config tuner// (restart included, rollback available there).export default function InsightsPanel({ conn, engine, isAdmin }) {diff --git a/frontend/src/components/deploy-console/ErrorCard.jsx b/frontend/src/components/deploy-console/ErrorCard.jsxindex d9302893..5ec0a103 100644--- a/frontend/src/components/deploy-console/ErrorCard.jsx+++ b/frontend/src/components/deploy-console/ErrorCard.jsx@@ -5,7 +5,7 @@ import { CopyButton } from '@/components/CopyButton';import { useTranslation } from 'react-i18next';import { Button as SharedButton } from '@/components/ui/button';-// Pinned failure card (plan 51 §1.1): failed step name, the one-line error, a+// Pinned failure card: failed step name, the one-line error, a// plain-language hint when a heuristic matched, actions (Retry / Copy / Ask AI)// and the persisted failure tail behind a disclosure.//diff --git a/frontend/src/components/deploy-console/SuccessBanner.jsx b/frontend/src/components/deploy-console/SuccessBanner.jsxindex bf571868..0deccad9 100644--- a/frontend/src/components/deploy-console/SuccessBanner.jsx+++ b/frontend/src/components/deploy-console/SuccessBanner.jsx@@ -14,7 +14,7 @@ const fmtSeconds = (s) => {// Long enough to read the outcome, short enough that you don't sit waiting.const AUTO_RETURN_SECONDS = 10;-// Completion banner (plan 51 §1.1): total duration, per-step timings, and the+// Completion banner: total duration, per-step timings, and the// payoff actions — Open app (when a live URL exists), View service, View// runtime logs.//diff --git a/frontend/src/components/domains/CutoverDrawer.jsx b/frontend/src/components/domains/CutoverDrawer.jsxindex 21c0d8f4..b408accc 100644--- a/frontend/src/components/domains/CutoverDrawer.jsx+++ b/frontend/src/components/domains/CutoverDrawer.jsx@@ -13,7 +13,7 @@ import { useToast } from '../../contexts/useToast.js';import Spinner from '../Spinner';import { useTranslation } from 'react-i18next';-// Per-domain reversible DNS cutover (plan 31 #5/#6). One shared slide-over,+// Per-domain reversible DNS cutover. One shared slide-over,// reached from the /domains detail drawer and from the Import wizard's final// step, so the survey → migrate → cutover journey ends in the same place.//diff --git a/frontend/src/components/ds/KpiBand.jsx b/frontend/src/components/ds/KpiBand.jsxindex de31b05b..96948ffc 100644--- a/frontend/src/components/ds/KpiBand.jsx+++ b/frontend/src/components/ds/KpiBand.jsx@@ -4,7 +4,7 @@ import { cn } from '@/lib/utils';import { Button as SharedButton } from '@/components/ui/button';// KpiBand — the one responsive grid wrapper for KPI/stat tiles (design-system-// primitive, plan 20). Lays a row of <MetricCard> tiles into a single grid so+// primitive). Lays a row of <MetricCard> tiles into a single grid so// every page's summary strip shares the same spacing + collapse behaviour// instead of ~20 hand-rolled `*-kpis` grids.//diff --git a/frontend/src/components/ds/status.js b/frontend/src/components/ds/status.jsindex 0bddc94c..6c8d9850 100644--- a/frontend/src/components/ds/status.js+++ b/frontend/src/components/ds/status.js@@ -1,4 +1,4 @@-// ONE frontend status → tone vocabulary (plan 77 D3).+// ONE frontend status → tone vocabulary.//// Every page used to roll its own status→color map, so "running" rendered// cyan on some pages and green or amber on others. This module is the singlediff --git a/frontend/src/components/git/BitbucketRepoPicker.jsx b/frontend/src/components/git/BitbucketRepoPicker.jsxindex 864abb1f..dd5133d6 100644--- a/frontend/src/components/git/BitbucketRepoPicker.jsx+++ b/frontend/src/components/git/BitbucketRepoPicker.jsx@@ -1,7 +1,7 @@import RepoPicker from './RepoPicker';import { bitbucketProvider } from './repoProviders';-// Thin binding over the shared picker contract (plan 79 G1). The four+// Thin binding over the shared picker contract. The four// provider pickers were near-identical copies; the shape they shared now// lives in RepoPicker and the differences in repoProviders.const BitbucketRepoPicker = ({ onPick }) => (diff --git a/frontend/src/components/git/GiteaRepoPicker.jsx b/frontend/src/components/git/GiteaRepoPicker.jsxindex 1d52db06..ab738acd 100644--- a/frontend/src/components/git/GiteaRepoPicker.jsx+++ b/frontend/src/components/git/GiteaRepoPicker.jsx@@ -1,7 +1,7 @@import RepoPicker from './RepoPicker';import { giteaProvider } from './repoProviders';-// Thin binding over the shared picker contract (plan 79 G1). The four+// Thin binding over the shared picker contract. The four// provider pickers were near-identical copies; the shape they shared now// lives in RepoPicker and the differences in repoProviders.const GiteaRepoPicker = ({ onPick }) => (diff --git a/frontend/src/components/git/GithubRepoPicker.jsx b/frontend/src/components/git/GithubRepoPicker.jsxindex e6e552d9..35cd6024 100644--- a/frontend/src/components/git/GithubRepoPicker.jsx+++ b/frontend/src/components/git/GithubRepoPicker.jsx@@ -1,7 +1,7 @@import RepoPicker from './RepoPicker';import { githubProvider } from './repoProviders';-// Thin binding over the shared picker contract (plan 79 G1). The four+// Thin binding over the shared picker contract. The four// provider pickers were near-identical copies; the shape they shared now// lives in RepoPicker and the differences in repoProviders.const GithubRepoPicker = ({ onPick }) => (diff --git a/frontend/src/components/git/GitlabRepoPicker.jsx b/frontend/src/components/git/GitlabRepoPicker.jsxindex f3f4a298..015751b8 100644--- a/frontend/src/components/git/GitlabRepoPicker.jsx+++ b/frontend/src/components/git/GitlabRepoPicker.jsx@@ -1,7 +1,7 @@import RepoPicker from './RepoPicker';import { gitlabProvider } from './repoProviders';-// Thin binding over the shared picker contract (plan 79 G1). The four+// Thin binding over the shared picker contract. The four// provider pickers were near-identical copies; the shape they shared now// lives in RepoPicker and the differences in repoProviders.const GitlabRepoPicker = ({ onPick }) => (diff --git a/frontend/src/components/git/RepoPicker.jsx b/frontend/src/components/git/RepoPicker.jsxindex 46030109..26def794 100644--- a/frontend/src/components/git/RepoPicker.jsx+++ b/frontend/src/components/git/RepoPicker.jsx@@ -6,7 +6,7 @@ import { Input } from '@/components/ui/input';import { Select, SelectTrigger, SelectContent, SelectItem, SelectValue } from '@/components/ui/select';/**- * One repo picker for every git provider (plan 79 G1).+ * One repo picker for every git provider.** Four near-identical components used to exist — GitHub, GitLab, Gitea and* Bitbucket — differing in which API functions they called, one URL shape, anddiff --git a/frontend/src/components/git/repoProviders.jsx b/frontend/src/components/git/repoProviders.jsxindex a9133cbb..51e216da 100644--- a/frontend/src/components/git/repoProviders.jsx+++ b/frontend/src/components/git/repoProviders.jsx@@ -3,7 +3,7 @@ import { Trans } from 'react-i18next';import { SiGithub, SiGitlab, SiGitea, SiBitbucket } from 'react-icons/si';import api from '../../services/api';-// Provider behaviour for RepoPicker (plan 79 G1). Everything visual lives in+// Provider behaviour for RepoPicker. Everything visual lives in// the component; these describe only what actually differs between providers —// which API to call, how a clone URL is shaped, and what to say when the// provider is not usable yet.diff --git a/frontend/src/components/managedCapabilities.js b/frontend/src/components/managedCapabilities.jsindex 25038d72..ad589a3d 100644--- a/frontend/src/components/managedCapabilities.js+++ b/frontend/src/components/managedCapabilities.js@@ -1,4 +1,4 @@-// Managed profile (ServerKit Cloud, plan 25)+// Managed profile (ServerKit Cloud)//// When ServerKit Cloud holds a Managed scope for this server it sends a signed// presentation policy naming the capabilities it has taken over. This ONE@@ -49,7 +49,7 @@ export const MANAGED_CAPABILITY_MAP = {},// Panel/agent update screens and self-update. The self-update section in// Settings › About collapses to the card in miniature. (The panel's- // self-update still runs; the card says so until plan 08's rings own it.)+ // self-update still runs; the card says so until update rings own it.)updates: {labelKey: 'managed.capability.updates',label: 'Updates',diff --git a/frontend/src/components/marketplace/ExtensionPermissionsDialog.jsx b/frontend/src/components/marketplace/ExtensionPermissionsDialog.jsxindex ff53a19a..6bc66a0c 100644--- a/frontend/src/components/marketplace/ExtensionPermissionsDialog.jsx+++ b/frontend/src/components/marketplace/ExtensionPermissionsDialog.jsx@@ -236,7 +236,7 @@ const RequirementsSection = ({ requirements }) => {);};-// Per-extension honesty surface (plan 55 tasks 6 + 7): what the extension+// Per-extension honesty surface (tasks 6 + 7): what the extension// declared, what the panel actually saw it do, what it was refused, and which// Python packages the panel declined to install.const ExtensionPermissionsDialog = ({ plugin, onClose }) => {diff --git a/frontend/src/components/marketplace/ManualInstallModal.jsx b/frontend/src/components/marketplace/ManualInstallModal.jsxindex a2d49fe6..0e56d347 100644--- a/frontend/src/components/marketplace/ManualInstallModal.jsx+++ b/frontend/src/components/marketplace/ManualInstallModal.jsx@@ -55,7 +55,7 @@ const SourceInput = ({</div>);-// Signature verdict badge for the consent card (plan 55). 'verified' means the+// Signature verdict badge for the consent card. 'verified' means the// release zip's ed25519 signature checked out against a publisher key pinned// by this panel; everything else is an honest not-verified treatment.const SignatureBadge = ({ signature }) => {diff --git a/frontend/src/components/monitoring/monitorShared.jsx b/frontend/src/components/monitoring/monitorShared.jsxindex 792fd3ea..3aa7d0a9 100644--- a/frontend/src/components/monitoring/monitorShared.jsx+++ b/frontend/src/components/monitoring/monitorShared.jsx@@ -46,5 +46,5 @@ export function monitorStateOf(monitor) {export const INCIDENT_STATES = ['investigating', 'identified', 'monitoring', 'resolved'];-// Impact levels ride the shared vocabulary (plan 77 D3).+// Impact levels ride the shared vocabulary.export const impactTone = (impact) => statusKind(impact);diff --git a/frontend/src/components/security/OverviewTab.jsx b/frontend/src/components/security/OverviewTab.jsxindex 4e4213c7..ea30c7ff 100644--- a/frontend/src/components/security/OverviewTab.jsx+++ b/frontend/src/components/security/OverviewTab.jsx@@ -35,7 +35,7 @@ const OverviewTab = ({ status, onRefresh, onNavigateTab }) => {// Do any installed extensions contribute Security tabs? When none do, the// footer offers the Marketplace instead of hardcoding per-tool nag rows —- // the plan 47 Ph3e degradation: core posture stays core-only.+ // the security-suite extraction: core posture stays core-only.const { tabs: contributedTabs } = useContributions();const hasSecurityExtensions = (contributedTabs || []).some((tab) => tab.group === 'security');diff --git a/frontend/src/components/serverdetail/SurveyTab.jsx b/frontend/src/components/serverdetail/SurveyTab.jsxindex 05c4cef5..1dddabc8 100644--- a/frontend/src/components/serverdetail/SurveyTab.jsx+++ b/frontend/src/components/serverdetail/SurveyTab.jsx@@ -20,7 +20,7 @@ import {} from 'lucide-react';import { toastError } from '@/utils/errorMessage';-// Survey tab (plan 27/28) — the read-only "Server Map" for a paired agent.+// Survey tab — the read-only "Server Map" for a paired agent.//// A survey is a strictly read-only "flight": the agent runs a declarative probe// catalog and returns what's running on the box; the panel normalizes it into adiff --git a/frontend/src/components/serverdetail/serverDetailData.js b/frontend/src/components/serverdetail/serverDetailData.jsindex 001912c5..258dc345 100644--- a/frontend/src/components/serverdetail/serverDetailData.js+++ b/frontend/src/components/serverdetail/serverDetailData.js@@ -2,7 +2,7 @@ import { statusKind } from '../ds/status.js';// Server status → ds Pill tone (shared by the header pill and the// Overview "Status" row).-// Server connection states ride the shared vocabulary (plan 77 D3).+// Server connection states ride the shared vocabulary.export const serverStatusKind = (status) => statusKind(status);export const PRESET_LABELS = {diff --git a/frontend/src/components/service-detail/AttachmentsCard.jsx b/frontend/src/components/service-detail/AttachmentsCard.jsxindex 8a690aa2..ed7051c9 100644--- a/frontend/src/components/service-detail/AttachmentsCard.jsx+++ b/frontend/src/components/service-detail/AttachmentsCard.jsx@@ -27,7 +27,7 @@ const DEFAULT_TEMPLATES = {// Until the server says otherwise (a Grafana install also takes metrics/logs).const DEFAULT_KINDS = ['cache', 'storage', 'queue', 'tracing'];-// "Attach → Cache / Storage / Queue" (plan 86 §C4): reuse an installed+// "Attach → Cache / Storage / Queue": reuse an installed// service or install one, write the env references, then offer a redeploy.export default function AttachmentsCard({ app }) {const { t } = useTranslation();diff --git a/frontend/src/components/service-detail/HintsCard.jsx b/frontend/src/components/service-detail/HintsCard.jsxindex 356bc276..53c4035e 100644--- a/frontend/src/components/service-detail/HintsCard.jsx+++ b/frontend/src/components/service-detail/HintsCard.jsx@@ -4,7 +4,7 @@ import { Lightbulb } from 'lucide-react';import { useTranslation } from 'react-i18next';import api from '../../services/api';-// "Where is it slow?" (plan 86 §A5): rule-based hints from the app's request+// "Where is it slow?": rule-based hints from the app's request// metrics, its container CPU and its database. Each names the component that// fits the signal and that component's failure mode; nothing is ever added// for you. Renders nothing when there is no hint.diff --git a/frontend/src/components/service-detail/OverviewTab.jsx b/frontend/src/components/service-detail/OverviewTab.jsxindex 9ffc9ec3..4f49c11e 100644--- a/frontend/src/components/service-detail/OverviewTab.jsx+++ b/frontend/src/components/service-detail/OverviewTab.jsx@@ -331,16 +331,16 @@ const OverviewTab = ({ app, deployConfig }) => {{/* Traffic (timed access log; hidden until requests exist) */}<RequestMetricsCard appId={app.id} />- {/* Bottleneck hints from the traffic above (plan 86 §A5) */}+ {/* Bottleneck hints from the traffic above */}<HintsCard app={app} />- {/* Cache / storage / queue this app uses (plan 86 §C4) */}+ {/* Cache / storage / queue this app uses */}<AttachmentsCard app={app} />- {/* PgBouncer beside an installed PostgreSQL (plan 86 §D1) */}+ {/* PgBouncer beside an installed PostgreSQL */}<PoolerCard app={app} />- {/* A/B slot deploys: live release, warm standby, switch back (plan 87) */}+ {/* A/B slot deploys: live release, warm standby, switch back */}<SlotsCard app={app} />{/* Recent Deployments */}diff --git a/frontend/src/components/service-detail/PoolerCard.jsx b/frontend/src/components/service-detail/PoolerCard.jsxindex 258b5056..3d30f7db 100644--- a/frontend/src/components/service-detail/PoolerCard.jsx+++ b/frontend/src/components/service-detail/PoolerCard.jsx@@ -5,7 +5,7 @@ import { Switch } from '@/components/ui/switch';import { useToast } from '../../contexts/useToast.js';import { toastError } from '@/utils/errorMessage';-// Opt-in PgBouncer beside an installed PostgreSQL (plan 86 §D1). Renders only+// Opt-in PgBouncer beside an installed PostgreSQL. Renders only// for PostgreSQL installs. Apps keep the direct connection unless they switch// their reference to `pooledUrl`, because transaction pooling breaks session// features, and that tradeoff is stated where the choice is made.diff --git a/frontend/src/components/service-detail/RequestMetricsCard.jsx b/frontend/src/components/service-detail/RequestMetricsCard.jsxindex b1f0cf25..8466f6cf 100644--- a/frontend/src/components/service-detail/RequestMetricsCard.jsx+++ b/frontend/src/components/service-detail/RequestMetricsCard.jsx@@ -27,7 +27,7 @@ function formatMs(ms) {: `${formatNumber(ms)} ms`;}-// Requests / errors / latency / cache from the timed nginx log (plan 86 §A2).+// Requests / errors / latency / cache from the timed nginx log.// Hidden until the app has served a request in the window.export default function RequestMetricsCard({ appId }) {const { t } = useTranslation();diff --git a/frontend/src/components/service-detail/SettingsTab.jsx b/frontend/src/components/service-detail/SettingsTab.jsxindex f616a561..f675de84 100644--- a/frontend/src/components/service-detail/SettingsTab.jsx+++ b/frontend/src/components/service-detail/SettingsTab.jsx@@ -344,7 +344,7 @@ const SettingsTab = ({ app, deployConfig, domains, primaryDomain, onUpdate }) =></div>)}- {/* Cache — opt-in nginx micro-cache (task #21, plan 86 §B3):+ {/* Cache — opt-in nginx micro-cache:short-TTL page cache with auth/admin/cart bypasses, staleserving, and a per-site purge. */}{section === 'cache' && (@@ -354,8 +354,8 @@ const SettingsTab = ({ app, deployConfig, domains, primaryDomain, onUpdate }) =></div>)}- {/* Health & Rollout (Docker only) — the deploy health gate- (plan 87): where a new release is asked, and for how long. */}+ {/* Health & Rollout (Docker only) — the deploy health gate:+where a new release is asked, and for how long. */}{section === 'health' && (<div className="svc-settings__section"><h3 className="svc-settings__section-title">{t('app.settingsTab.healthRollout', 'Health and rollout')}</h3>diff --git a/frontend/src/components/service-detail/SlotsCard.jsx b/frontend/src/components/service-detail/SlotsCard.jsxindex 5414373c..a60b7082 100644--- a/frontend/src/components/service-detail/SlotsCard.jsx+++ b/frontend/src/components/service-detail/SlotsCard.jsx@@ -9,7 +9,7 @@ import { useConfirm } from '@/hooks/useConfirm';import { formatRelativeShort } from '@/utils/intl';import { toastError } from '@/utils/errorMessage';-// A/B slot deploys (plan 87 §F). Shows which slot serves, which one is the+// A/B slot deploys. Shows which slot serves, which one is the// standby and for how long it stays warm, with the instant switch back. When// the feature is off it says why the app does or does not qualify.function minutesLeft(until) {diff --git a/frontend/src/components/settings/AboutTab.jsx b/frontend/src/components/settings/AboutTab.jsxindex ea9105cc..ef12b108 100644--- a/frontend/src/components/settings/AboutTab.jsx+++ b/frontend/src/components/settings/AboutTab.jsx@@ -33,7 +33,7 @@ const AboutTab = () => {const [updateError, setUpdateError] = useState(null);const cancelledRef = useRef(false);const register = useSettingFocus();- // Updates held by ServerKit Cloud (plan 25): the self-update surface is+ // Updates held by ServerKit Cloud: the self-update surface is// the managed card in miniature. The panel still updates itself — the// card says so.const { isControlHeld, profile: managedProfile } = useManagedProfile();diff --git a/frontend/src/components/settings/CloudTab.jsx b/frontend/src/components/settings/CloudTab.jsxindex 29fce895..c5246145 100644--- a/frontend/src/components/settings/CloudTab.jsx+++ b/frontend/src/components/settings/CloudTab.jsx@@ -8,7 +8,7 @@ import { MANAGED_CAPABILITY_MAP } from '../sidebarItems';import EmptyState from '../EmptyState';import ErrorState from '../ErrorState';-// Settings › ServerKit Cloud (plan 25 M3): the one place the customer reads+// Settings › ServerKit Cloud: the one place the customer reads// what ServerKit Cloud holds for them — the connect state, and the managed// profile with the responsibilities Cloud took over, since when, until when,// and any active support override. Nothing here can turn the profile off;diff --git a/frontend/src/components/settings/LanguageSelector.jsx b/frontend/src/components/settings/LanguageSelector.jsxindex 3a101ba8..405d6121 100644--- a/frontend/src/components/settings/LanguageSelector.jsx+++ b/frontend/src/components/settings/LanguageSelector.jsx@@ -7,7 +7,7 @@ import { useLocale } from '../../contexts/useLocale.js';import useSettingFocus from '../../hooks/useSettingFocus';/**- * Panel language (plan 79 B3).+ * Panel language.** Lives next to the theme picker because it is the same shape of choice: a* per-user preference that changes how every screen reads. It also persistsdiff --git a/frontend/src/components/settings/MemberActionsCard.jsx b/frontend/src/components/settings/MemberActionsCard.jsxindex f31d19ee..11fd2f6e 100644--- a/frontend/src/components/settings/MemberActionsCard.jsx+++ b/frontend/src/components/settings/MemberActionsCard.jsx@@ -3,7 +3,7 @@ import api from '../../services/api';import { Button } from '@/components/ui/button';import { useTranslation } from 'react-i18next';-// Admin control for the member-action escape hatch (plan 19 Phase 5 / plan 29 #13).+// Admin control for the member-action escape hatch.// Curated, parameterized actions a workspace member may run for an app they can// reach (no free text ever reaches a shell; every run is audit-logged). On by// default — this surface just makes the flag visible so an operator can turn thediff --git a/frontend/src/components/settings/SidebarSettings.jsx b/frontend/src/components/settings/SidebarSettings.jsxindex 7c30161d..130047e9 100644--- a/frontend/src/components/settings/SidebarSettings.jsx+++ b/frontend/src/components/settings/SidebarSettings.jsx@@ -33,7 +33,7 @@ const SidebarSettings = () => {const [saving, setSaving] = useState(false);const [message, setMessage] = useState(null);const register = useSettingFocus();- // Items ServerKit Cloud holds under the managed profile (plan 25) are not+ // Items ServerKit Cloud holds under the managed profile are not// offered as things to re-add — they left every preset already.const { hiddenSidebarIds: managedHidden } = useManagedProfile();diff --git a/frontend/src/components/settings/StorageTab.jsx b/frontend/src/components/settings/StorageTab.jsxindex 35398d35..584368c1 100644--- a/frontend/src/components/settings/StorageTab.jsx+++ b/frontend/src/components/settings/StorageTab.jsx@@ -41,7 +41,7 @@ function diskTone(percent) {}/**- * Where the panel host's disk goes (plan 85 §D1/§D2). Reads the storage+ * Where the panel host's disk goes. Reads the storage* overview, hands cleanup to the existing curated reclaim flow, and edits the* retention settings that bound ServerKit's own share of the disk.*/diff --git a/frontend/src/components/settings/ThemeBrowseModal.jsx b/frontend/src/components/settings/ThemeBrowseModal.jsxindex 9a596ecd..41fc41de 100644--- a/frontend/src/components/settings/ThemeBrowseModal.jsx+++ b/frontend/src/components/settings/ThemeBrowseModal.jsx@@ -10,7 +10,7 @@ import { useTranslation } from 'react-i18next';import { Button as SharedButton } from '@/components/ui/button';import { toastError } from '@/utils/errorMessage';-// Browse & install community themes from the registry (plan 60, Phase 3).+// Browse & install community themes from the registry.// Offline-tolerant: if the registry is unreachable the panel falls back to the// bundled index, so this never hard-fails — it just shows fewer (or no) cards.const ThemeBrowseModal = ({ open, onOpenChange }) => {diff --git a/frontend/src/components/settings/ThemeStudioModal.jsx b/frontend/src/components/settings/ThemeStudioModal.jsxindex 8e2e8864..d789f1dd 100644--- a/frontend/src/components/settings/ThemeStudioModal.jsx+++ b/frontend/src/components/settings/ThemeStudioModal.jsx@@ -31,7 +31,7 @@ function seedTokens(theme, mode) {return { ...stock, ...from };}-// Theme Studio (plan 60, Phase 4) — the "SDK" for a data format is docs ++// Theme Studio — the "SDK" for a data format is docs +// tooling. Edit colors over the LIVE panel (every change applies instantly via// the skin preview), start from any installed theme, then Export a valid// theme.json, Save it into this panel, or Submit it to the registry.diff --git a/frontend/src/components/settings/TwoFactorPolicyCard.jsx b/frontend/src/components/settings/TwoFactorPolicyCard.jsxindex 1e97bcb7..34976c55 100644--- a/frontend/src/components/settings/TwoFactorPolicyCard.jsx+++ b/frontend/src/components/settings/TwoFactorPolicyCard.jsx@@ -6,7 +6,7 @@ import { Input } from '@/components/ui/input';import { Select, SelectTrigger, SelectContent, SelectItem, SelectValue } from '@/components/ui/select';import { useTranslation } from 'react-i18next';-// Admin control for the require-2FA policy (plan 22 #14). A policy, never a+// Admin control for the require-2FA policy. A policy, never a// default: 'off' (nobody forced), 'admins', or 'all'. Within the grace window a// user still logs in with a password + a nudge; past it, login yields an// enrollment-scoped token until they add a passkey or authenticator app.diff --git a/frontend/src/components/setup/SetupStepSummary.jsx b/frontend/src/components/setup/SetupStepSummary.jsxindex 65f7e813..8a9146e0 100644--- a/frontend/src/components/setup/SetupStepSummary.jsx+++ b/frontend/src/components/setup/SetupStepSummary.jsx@@ -41,7 +41,7 @@ const SetupStepSummary = ({ accountInfo, useCases, twoFactorEnabled, onFinish })const [installing, setInstalling] = useState(false);const [installState, setInstallState] = useState({}); // slug -> 'installing'|'done'|'error'- // Security posture (plan 47 Ph5). Levels come catalog-resolved from the+ // Security posture. Levels come catalog-resolved from the// backend — a level only lists extensions that are installable right now,// so this section renders honestly even before every security extension// is published. 'minimal' is the lean default.@@ -215,7 +215,7 @@ const SetupStepSummary = ({ accountInfo, useCases, twoFactorEnabled, onFinish })</span></div>- {/* Security posture (plan 47 Ph5): how much tooling to+ {/* Security posture: how much tooling toinstall now. Only levels that resolve at least oneinstallable extension differ from "minimal"; each cardnames exactly what it would install. */}diff --git a/frontend/src/components/sidebarItems.js b/frontend/src/components/sidebarItems.jsindex cf3a6286..58d129b3 100644--- a/frontend/src/components/sidebarItems.js+++ b/frontend/src/components/sidebarItems.js@@ -23,7 +23,7 @@ export const SIDEBAR_CATEGORIES = ['overview', 'infrastructure', 'operations', '// probe caught it.//// Keys resolve at RENDER, not at import: a label translated at module load-// would translate once and never follow a locale switch (plan 79 §E).+// would translate once and never follow a locale switch.export const SIDEBAR_CATEGORY_LABELS = {overview: { labelKey: 'nav.category.overview', label: 'Overview' },infrastructure: { labelKey: 'nav.category.infrastructure', label: 'Infrastructure' },@@ -105,8 +105,7 @@ export const SIDEBAR_ITEMS = [category: 'infrastructure',icon: '<path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/>'},- // WordPress is the standalone serverkit-wordpress extension (plan 52- // Phase 5 — registry-installed, offered in the setup wizard);+ // WordPress is the standalone serverkit-wordpress extension (registry-installed, offered in the setup wizard);// its sidebar item is contributed by the extension manifest (nav), so it// disappears cleanly when the extension is uninstalled.// Automations (tramo) is the standalone serverkit-tramo extension (own repo,@@ -287,7 +286,7 @@ export const SIDEBAR_PRESETS = {hiddenItems: ['workflow', 'databases', 'docker', 'git', 'email', 'cron', ...ADVANCED_ITEM_IDS]}// Note: no 'wordpress' literal — its nav item is contributed by the- // serverkit-wordpress extension manifest (plan 52 Phase 4), so presets+ // serverkit-wordpress extension manifest, so presets// don't hardcode an extension's id; uninstalled = absent.};@@ -365,7 +364,7 @@ export function applyWorkspaceNavPermissions(items, workspace, user) {}// ----------------------------------------------------------------------------// Managed profile (ServerKit Cloud, plan 25)+// Managed profile (ServerKit Cloud)//// The one table mapping a held managed capability to the sidebar ids it// removes, the route prefixes whose pages render the managed card, and thediff --git a/frontend/src/constants/events.js b/frontend/src/constants/events.jsindex eaa9d7d2..5b8f1bdd 100644--- a/frontend/src/constants/events.js+++ b/frontend/src/constants/events.js@@ -1,4 +1,4 @@-// Shared wire-protocol constants (plan 77 E3).+// Shared wire-protocol constants.//// This table mirrors backend/app/constants.py::SOCKET_EVENTS verbatim — a// backend test (tests/test_socket_contract.py) parses this file and fails@@ -27,7 +27,7 @@ export const SOCKET_EVENTS = {DEPLOY_LOG: 'deploy_log',DEPLOY_STATUS: 'deploy_status',- // generalized run envelope (plan 77 E1) — one event pair for every run kind+ // generalized run envelope — one event pair for every run kindRUN_LOG: 'run_log',RUN_STATUS: 'run_status',diff --git a/frontend/src/contexts/AuthContext.jsx b/frontend/src/contexts/AuthContext.jsxindex 62f34669..7e71f98e 100644--- a/frontend/src/contexts/AuthContext.jsx+++ b/frontend/src/contexts/AuthContext.jsx@@ -20,7 +20,7 @@ export function AuthProvider({ children }) {panelTitle: import.meta.env.VITE_PANEL_TITLE || 'ServerKit',publicTitle: 'Control Panel',loginLayout: 'centered',- // Panel-wide default language for the pre-auth screens (plan 79 A4).+ // Panel-wide default language for the pre-auth screens.// null = not fetched yet, so the browser language does not win a race// against a panel that has an opinion.defaultLanguage: null,diff --git a/frontend/src/contexts/LocaleContext.jsx b/frontend/src/contexts/LocaleContext.jsxindex be636bda..1b1c21a2 100644--- a/frontend/src/contexts/LocaleContext.jsx+++ b/frontend/src/contexts/LocaleContext.jsx@@ -9,7 +9,7 @@ import {import { LocaleContext } from './useLocale.js';/**- * Owns the active locale (plan 79 §B1).+ * Owns the active locale.** Sits ABOVE AuthProvider — the login screen has to be translated before* anyone is signed in — so it cannot read auth state itself. The bridge isdiff --git a/frontend/src/contexts/ManagedProfileContext.jsx b/frontend/src/contexts/ManagedProfileContext.jsxindex afd55c9a..b6cf2609 100644--- a/frontend/src/contexts/ManagedProfileContext.jsx+++ b/frontend/src/contexts/ManagedProfileContext.jsx@@ -8,7 +8,7 @@ import {managedSidebarIds,} from '../components/sidebarItems';-// The managed profile (plan 25). One fetch per panel load, next to the+// The managed profile. One fetch per panel load, next to the// connect status: ServerKit Cloud's signed presentation policy, naming the// capabilities it holds for this customer. Everything the UI needs derives// from it here so the sidebar, the palette, the route gate and the in-pagediff --git a/frontend/src/contexts/managedProfileContextValue.js b/frontend/src/contexts/managedProfileContextValue.jsindex 64152189..e00ad457 100644--- a/frontend/src/contexts/managedProfileContextValue.js+++ b/frontend/src/contexts/managedProfileContextValue.js@@ -1,6 +1,6 @@import { createContext } from 'react';-// The managed-profile context value (plan 25). Kept in its own module so the+// The managed-profile context value. Kept in its own module so the// provider (a component file) and useManagedProfile (the hook) share one// context object without either exporting across the react-refresh boundary.const ManagedProfileContext = createContext({diff --git a/frontend/src/contexts/useManagedProfile.js b/frontend/src/contexts/useManagedProfile.jsindex d5c75ee4..58595f61 100644--- a/frontend/src/contexts/useManagedProfile.js+++ b/frontend/src/contexts/useManagedProfile.js@@ -1,7 +1,7 @@import { useContext } from 'react';import ManagedProfileContext from './managedProfileContextValue';-// Read the managed profile (plan 25) anywhere under DashboardLayout: whether+// Read the managed profile anywhere under DashboardLayout: whether// it is active, the held capabilities, the sidebar ids it removes, the// capability a path's managed card belongs to, and whether a named in-page// control is held. Outside the provider the context default answers "nodiff --git a/frontend/src/data/bundledThemes.js b/frontend/src/data/bundledThemes.jsindex 78c94d55..d6cab4a8 100644--- a/frontend/src/data/bundledThemes.js+++ b/frontend/src/data/bundledThemes.js@@ -1,4 +1,4 @@-// Bundled seed themes shipped with the panel (plan 60).+// Bundled seed themes shipped with the panel.//// These are the always-present gallery entries — the "default" stock look plus// a handful of first-party skins — so the Theme Gallery has content on day onediff --git a/frontend/src/data/commandActions.js b/frontend/src/data/commandActions.jsindex 6b0035d8..45a62681 100644--- a/frontend/src/data/commandActions.js+++ b/frontend/src/data/commandActions.js@@ -1,4 +1,4 @@-// Runnable actions for the command palette (plan 41, Phase 3). Typing `>` filters+// Runnable actions for the command palette. Typing `>` filters// results to this list. v1 ships only safe, non-destructive verbs — openers and// navigation-with-intent — never blind destructive/exec commands (those belong to// entity rows with confirm dialogs; see the plan's "Deliberately deferred").diff --git a/frontend/src/data/palettePages.js b/frontend/src/data/palettePages.jsindex eb7c4b59..5e977739 100644--- a/frontend/src/data/palettePages.js+++ b/frontend/src/data/palettePages.js@@ -1,4 +1,4 @@-// Static top-level pages for the command palette (plan 41). Extracted from the+// Static top-level pages for the command palette. Extracted from the// old inline STATIC_PAGES so the palette component stays about orchestration.//// `navId` ties a page to its sidebar item id, letting the palette apply the SAMEdiff --git a/frontend/src/data/settingsIndex.js b/frontend/src/data/settingsIndex.jsindex 6b437b80..9dfe7cc7 100644--- a/frontend/src/data/settingsIndex.js+++ b/frontend/src/data/settingsIndex.js@@ -1,4 +1,4 @@-// Searchable settings index (plan 41, Phase 2). Every meaningful settings card+// Searchable settings index. Every meaningful settings card// or field — not just the tab — becomes a palette result that lands you on the// exact card via `/settings/<tab>?focus=setting:<id>` (see hooks/useSettingFocus).//diff --git a/frontend/src/data/themeTokens.js b/frontend/src/data/themeTokens.jsindex 19c72cee..5d4c8360 100644--- a/frontend/src/data/themeTokens.js+++ b/frontend/src/data/themeTokens.js@@ -1,7 +1,7 @@// ============================================// ServerKit theme token whitelist + alias table + validators// ============================================-// A ServerKit theme is DATA, not code (see docs/THEMING.md and plan 60): a map+// A ServerKit theme is DATA, not code (see docs/THEMING.md): a map// of canonical CSS custom-property names to values. This module is the single// client-side source of truth for// - which token names a theme may set (the whitelist),diff --git a/frontend/src/hooks/useDashboardBoards.js b/frontend/src/hooks/useDashboardBoards.jsindex ffa5a494..a1f36cea 100644--- a/frontend/src/hooks/useDashboardBoards.js+++ b/frontend/src/hooks/useDashboardBoards.js@@ -1,5 +1,5 @@/**- * Dashboard boards — load, edit and persist a user's widget layouts (plan 62).+ * Dashboard boards — load, edit and persist a user's widget layouts.** Supersedes `useDashboardLayout`, which kept a visibility list in* localStorage. Boards live server-side (`/api/v1/dashboards`) so a layoutdiff --git a/frontend/src/hooks/useFormat.js b/frontend/src/hooks/useFormat.jsindex 44e312e9..3f47f489 100644--- a/frontend/src/hooks/useFormat.js+++ b/frontend/src/hooks/useFormat.js@@ -3,7 +3,7 @@ import { useLocale } from '../contexts/useLocale.js';import * as intl from '../utils/intl';/**- * The format door for components (plan 79 §C).+ * The format door for components.** Same implementation as `utils/intl` — this is a subscription, not a second* door. Components need it because a locale switch has to re-render them;diff --git a/frontend/src/hooks/usePaletteAuthz.js b/frontend/src/hooks/usePaletteAuthz.jsindex b8bc62c9..b5cebd9b 100644--- a/frontend/src/hooks/usePaletteAuthz.js+++ b/frontend/src/hooks/usePaletteAuthz.js@@ -11,14 +11,14 @@ const ALWAYS_VISIBLE = new Set();/**- * The palette's authz gate (plan 41, Phase 1 #3). Mirrors exactly what the+ * The palette's authz gate. Mirrors exactly what the* sidebar shows so a member's palette can't surface admin surface:* - `adminOnly` items require an admin.* - Items tied to a sidebar `navId` respect the active workspace's per-role* nav-permission map (same source as applyWorkspaceNavPermissions), which* only ever NARROWS a member's view.* - Items whose capability ServerKit Cloud holds under the managed profile- * (plan 25) leave the palette too, same as they leave every sidebar preset.+ * leave the palette too, same as they leave every sidebar preset.** Note: this intentionally does NOT apply personal sidebar-preset hiding — a page* you hid from your sidebar for tidiness stays reachable via the palette.diff --git a/frontend/src/hooks/useSelfCapturedBones.js b/frontend/src/hooks/useSelfCapturedBones.jsindex 0aa81531..3035b5ff 100644--- a/frontend/src/hooks/useSelfCapturedBones.js+++ b/frontend/src/hooks/useSelfCapturedBones.js@@ -34,7 +34,7 @@ function writeCache(key, version, snapshot) {}/**- * Runtime self-capture of skeleton bones (Phase 3 of plan 50).+ * Runtime self-capture of skeleton bones.** After a page's real content has rendered, snapshot the referenced region into* bones and cache them in `localStorage` under `sk-bones:<key>`; on the NEXT loaddiff --git a/frontend/src/hooks/useServerStream.js b/frontend/src/hooks/useServerStream.jsindex 15de3450..f7519686 100644--- a/frontend/src/hooks/useServerStream.js+++ b/frontend/src/hooks/useServerStream.js@@ -1,5 +1,5 @@-// useServerStream — the ONE join/listen/cleanup dance for socket rooms-// (plan 77 E4). Components used to hand-roll connect + join_room + on(event)+// useServerStream — the ONE join/listen/cleanup dance for socket rooms.+// Components used to hand-roll connect + join_room + on(event)// + off/leave in slightly different ways (some forgot to re-join after a// reconnect, which silently kills the stream server-side). Both shapes live// here:diff --git a/frontend/src/hooks/useSettingFocus.js b/frontend/src/hooks/useSettingFocus.jsindex 443f816f..156c013f 100644--- a/frontend/src/hooks/useSettingFocus.js+++ b/frontend/src/hooks/useSettingFocus.js@@ -3,13 +3,13 @@ import useFocusParam from './useFocusParam';import { scrollBehavior } from '@/utils/reducedMotion';/**- * Settings deep-link focus (plan 41, Phase 2). A settings tab calls this hook+ * Settings deep-link focus. A settings tab calls this hook* once and spreads `register(id)` onto each card it wants to be landable from* the command palette. When the tab is opened via `/settings/<tab>?focus=setting:<id>`* the matching card is scrolled into view and flashed with `is-setting-focused`* for ~2s, then the highlight clears.*- * Rides the plan-33 `useFocusParam` rail with a new `setting` kind — the param+ * Rides the `useFocusParam` rail with a new `setting` kind — the param* fires once and is cleared, so a refresh doesn't re-trigger it.** Usage — pass the card's own class as the second arg so the flash class isdiff --git a/frontend/src/hooks/useTableViews.js b/frontend/src/hooks/useTableViews.jsindex 9ee64b9e..1b9252cc 100644--- a/frontend/src/hooks/useTableViews.js+++ b/frontend/src/hooks/useTableViews.js@@ -1,6 +1,6 @@// DEPRECATED re-export. The saved-view stack lives in `components/ds/grid/`// now, behind `useGridViews` — a page that reaches past it re-invents the-// envelope, which is exactly the divergence plan 69 removed.+// envelope, which is exactly the divergence the list-page convergence removed.//// Still here only for the pages not yet on the shared chrome (Email, Jobs,// Monitors, Telemetry). Delete this file once they are migrated; the brokendiff --git a/frontend/src/i18n/index.js b/frontend/src/i18n/index.jsindex 600cfce4..603054aa 100644--- a/frontend/src/i18n/index.js+++ b/frontend/src/i18n/index.js@@ -1,4 +1,4 @@-// Plan 79 A1/A2 — the i18next instance.+// The i18next instance.//// Delivery is deliberately NOT the usual http-backend fetch://diff --git a/frontend/src/i18n/labels.js b/frontend/src/i18n/labels.jsindex 414981e1..30d4766f 100644--- a/frontend/src/i18n/labels.js+++ b/frontend/src/i18n/labels.js@@ -2,7 +2,7 @@ import { useCallback } from 'react';import { useTranslation } from 'react-i18next';/**- * Resolve a declaratively-keyed label from a data object (plan 79 §E).+ * Resolve a declaratively-keyed label from a data object.** Data tables — sidebar items, tab tables, column definitions, wizard steps —* carry the pairdiff --git a/frontend/src/i18n/resolveLocale.js b/frontend/src/i18n/resolveLocale.jsindex 2d3b25d4..e0389978 100644--- a/frontend/src/i18n/resolveLocale.js+++ b/frontend/src/i18n/resolveLocale.js@@ -1,4 +1,4 @@-// Plan 79 A4 — locale precedence, as pure functions so it can be tested+// Locale precedence, as pure functions so it can be tested// without a browser, a store, or i18next.//// user.language (server, per-user)@@ -73,7 +73,7 @@ export function languageInfo(code) {|| LANGUAGES.find((language) => language.code === DEFAULT_LANGUAGE);}-/** Writing direction for a code — drives <html dir> (plan 79 §H). */+/** Writing direction for a code — drives <html dir>. */export function directionFor(code) {return languageInfo(code).dir || 'ltr';}diff --git a/frontend/src/layouts/DashboardLayout.jsx b/frontend/src/layouts/DashboardLayout.jsxindex 41fcdac4..094600d4 100644--- a/frontend/src/layouts/DashboardLayout.jsx+++ b/frontend/src/layouts/DashboardLayout.jsx@@ -157,7 +157,7 @@ const DashboardLayout = () => {);};-// The managed-profile gate (plan 25). A held capability's route still renders —+// The managed-profile gate. A held capability's route still renders —// it renders the managed card instead of the page content, so deep links,// handoffs and exports keep landing somewhere truthful. When the policy has// lapsed (Cloud unreachable past the expiry window) the full panel is back anddiff --git a/frontend/src/main.jsx b/frontend/src/main.jsxindex ec657818..93e954f3 100644--- a/frontend/src/main.jsx+++ b/frontend/src/main.jsx@@ -1,5 +1,5 @@// Capture the host's singleton vendor instances for runtime-loaded extension-// bundles BEFORE anything else runs (plan 25 Decision 2).+// bundles BEFORE anything else runs.import './plugins/runtime/vendorShare'import React from 'react'import ReactDOM from 'react-dom/client'diff --git a/frontend/src/pages/Backups.jsx b/frontend/src/pages/Backups.jsxindex b2c54dd9..7fd2721f 100644--- a/frontend/src/pages/Backups.jsx+++ b/frontend/src/pages/Backups.jsx@@ -136,7 +136,7 @@ const Backups = () => {const [stats, setStats] = useState(null);const scheduleStore = useBackupSchedules();const { schedules, refresh: reloadSchedules } = scheduleStore;- // Backup scheduling held by ServerKit Cloud (plan 25): the page and local+ // Backup scheduling held by ServerKit Cloud: the page and local// restore stay, the scheduling and destination surfaces become the card.const { isControlHeld, profile: managedProfile } = useManagedProfile();const backupsManaged = isControlHeld('backup-scheduling');diff --git a/frontend/src/pages/Coexistence.jsx b/frontend/src/pages/Coexistence.jsxindex c6fa0245..b0cf9fd0 100644--- a/frontend/src/pages/Coexistence.jsx+++ b/frontend/src/pages/Coexistence.jsx@@ -13,7 +13,7 @@ import api from '../services/api';import { useTranslation } from 'react-i18next';// Coexistence — the honest "running ServerKit alongside another control panel"-// surface (plan 27 #15, plan 31). Mirrors docs/COEXISTENCE.md: the three+// surface. Mirrors docs/COEXISTENCE.md: the three// adoption modes (Observe / Migrate / Manage), the read-only guarantees, and the// never-supported two-writers case. Any Observed servers currently paired are// listed with a link into the survey/migrate → DNS-cutover journey.diff --git a/frontend/src/pages/Databases.jsx b/frontend/src/pages/Databases.jsxindex 5c00e292..26d7796e 100644--- a/frontend/src/pages/Databases.jsx+++ b/frontend/src/pages/Databases.jsx@@ -667,7 +667,7 @@ export default function Databases() {if (node.conn?.dbType === 'docker' && node.conn.container) {// Curated config tuner is container-scoped (docker-only).actions.splice(2, 0, { labelKey: 'app.databases.configTuner', label: 'Config tuner', icon: SlidersHorizontal, onClick: () => setTunerTarget({ container: node.conn.container, engine: node.engine, password: node.conn.password }) });- // Top queries + hit ratio (plan 86 §A3), docker-only too.+ // Top queries + hit ratio, docker-only too.actions.splice(2, 0, { labelKey: 'app.databases.insights', label: 'Insights', icon: Gauge, onClick: () => openInsights(node.conn, node.engine) });}actions.splice(2, 0, { labelKey: 'app.databases.backUpDatabase', label: 'Back up database', icon: DatabaseBackup, onClick: () => backupDatabase(node) });diff --git a/frontend/src/pages/Jobs.jsx b/frontend/src/pages/Jobs.jsxindex 6b90f75d..5fe655a6 100644--- a/frontend/src/pages/Jobs.jsx+++ b/frontend/src/pages/Jobs.jsx@@ -51,7 +51,7 @@ const POLL_MS = 5000;// columnFilters — the chrome's client-side {match, rules} column rules.// Narrows the PAGE_SIZE rows already on screen.//-// They shared the name `filters` until plan 69, which is exactly how a preset+// They shared the name `filters` until the list-page convergence, which is exactly how a preset// could blank both server filters while filtering nothing. `serverFilters` is// namespaced inside `page` now; useTableChrome's `rename` keeps views users// saved under the old top-level `filters` working.diff --git a/frontend/src/pages/Marketplace.jsx b/frontend/src/pages/Marketplace.jsxindex 42224ca3..fb9336c5 100644--- a/frontend/src/pages/Marketplace.jsx+++ b/frontend/src/pages/Marketplace.jsx@@ -99,7 +99,7 @@ const getRegistryCatalogEntry = (entry) => ({firstParty: isFirstParty(entry.author, entry),trust: entry.trust || 'unreviewed',review: entry.review || null,- // Release-signature state from the index (plan 55): `signed` means the+ // Release-signature state from the index: `signed` means the// entry carries an ed25519 signature the panel verifies at install;// `publisherTrusted` means the named key is pinned by this panel.signed: Boolean(entry.signature),@@ -147,7 +147,7 @@ const TrustBadge = ({ entry }) => {return null;};-// Release-signature badge (plan 55). Shown on the registry detail modal next+// Release-signature badge. Shown on the registry detail modal next// to TrustBadge: 'signed · verified' means the index pins an ed25519 signature// whose publisher key this panel trusts (verified cryptographically at// install); unsigned entries get the honest unsigned treatment.@@ -249,7 +249,7 @@ const Marketplace = () => {// dialog (confirm retries with acknowledge_risk: true). Shape:// { slug, reason } where reason is 'unreviewed' (proactive gate or 409),// 'unverified' (409: entry has no pinned checksum), or 'untrusted_key'- // (signed by a publisher key this panel doesn't pin — plan 55).+ // (signed by a publisher key this panel doesn't pin).const [riskTarget, setRiskTarget] = useState(null);// Plugin pending uninstall — drives the keep-vs-purge data-policy dialog.const [uninstallTarget, setUninstallTarget] = useState(null);@@ -260,7 +260,7 @@ const Marketplace = () => {// Plugin whose config is being edited (#49) — drives the config dialog.const [configTarget, setConfigTarget] = useState(null);// Plugin whose declared-vs-observed permissions and pending Python- // dependencies are being read (plan 55 tasks 6+7) — drives the read-only+ // dependencies are being read (tasks 6+7) — drives the read-only// permissions dialog.const [permissionsTarget, setPermissionsTarget] = useState(null);@@ -369,8 +369,8 @@ const Marketplace = () => {// (the backend 409 path above covers the race/stale cases).setRiskTarget({ slug: entry.installKey, reason: 'unreviewed' });} else if (entry.signed && !entry.publisherTrusted) {- // Signed by a publisher key this panel doesn't pin — consent first- // (plan 55); the backend 409 path is the authoritative backstop.+ // Signed by a publisher key this panel doesn't pin — consent first;+ // the backend 409 path is the authoritative backstop.setRiskTarget({ slug: entry.installKey, reason: 'untrusted_key' });} else {handleRegistryInstall(entry.installKey);diff --git a/frontend/src/pages/Telemetry.jsx b/frontend/src/pages/Telemetry.jsxindex 979a418a..825dc767 100644--- a/frontend/src/pages/Telemetry.jsx+++ b/frontend/src/pages/Telemetry.jsx@@ -51,7 +51,7 @@ const SEVERITY_ORDER = ['critical', 'error', 'warning', 'info', 'debug'];// knows, or the badge silently renders without its background. `label` is the// one spelling of a severity the whole page uses: the pill, the filter drawer's// option list and the built-in view names all read from here.-// Severity tones ride the shared vocabulary (plan 77 D3); labels are local.+// Severity tones ride the shared vocabulary; labels are local.const SEVERITY_LABEL = {critical: 'Critical', error: 'Error', warning: 'Warning',info: 'Info', debug: 'Debug',diff --git a/frontend/src/pages/Templates.jsx b/frontend/src/pages/Templates.jsxindex d683edb5..e347ee61 100644--- a/frontend/src/pages/Templates.jsx+++ b/frontend/src/pages/Templates.jsx@@ -239,7 +239,7 @@ const Templates = () => {const [filtersOpen, setFiltersOpen] = useState(false);// Deploying targets a fleet ServerKit Cloud operates under the managed- // profile (plan 25): the catalog stays browsable, the Deploy control goes.+ // profile: the catalog stays browsable, the Deploy control goes.const { isControlHeld, profile: managedProfile } = useManagedProfile();const deployManaged = isControlHeld('templates-deploy');diff --git a/frontend/src/pages/new-service/NewService.jsx b/frontend/src/pages/new-service/NewService.jsxindex 33aa3505..6fffe918 100644--- a/frontend/src/pages/new-service/NewService.jsx+++ b/frontend/src/pages/new-service/NewService.jsx@@ -16,7 +16,7 @@ const STEPS = [{ n: 3, labelKey: 'app.newService.review', label: 'Review' },];-// New Service — a real three-step wizard (plan 43 Phase 3). Step state and+// New Service — a real three-step wizard. Step state and// submit live in the form hook; each step is a presentational component.const NewService = () => {const { t } = useTranslation();diff --git a/frontend/src/plugins/contributions.js b/frontend/src/plugins/contributions.jsindex 1104d3aa..3bef197e 100644--- a/frontend/src/plugins/contributions.js+++ b/frontend/src/plugins/contributions.js@@ -116,7 +116,7 @@ const EMPTY = {// tool-result renderers. Consumed by the core AIAssistant via// useContributions().ai.ai: { suggested_prompts: [], tool_renderers: [] },- // Runtime-frontend descriptor map { slug: { entry, hashes } } (plan 25).+ // Runtime-frontend descriptor map { slug: { entry, hashes } }.// Present only for installed extensions shipping a prebuilt ESM bundle;// empty for baked builtins and when the kill switch is off.frontends: {},@@ -265,7 +265,7 @@ export function refreshContributions() {// routes render with their components already available (fail-soft:// a bundle that can't load records an error state, never throws).// Pass the panel's SDK version so the loader can refuse a bundle- // built against an incompatible SDK before fetching it (plan 32 #1).+ // built against an incompatible SDK before fetching it.await loadRuntimeFrontends(merged.frontends, merged.panel_sdk_version || merged.sdk_version);if (requestGeneration !== generation) return cachedValue || EMPTY;diff --git a/frontend/src/plugins/runtime/ExtensionBoundary.jsx b/frontend/src/plugins/runtime/ExtensionBoundary.jsxindex 626e4127..f8305449 100644--- a/frontend/src/plugins/runtime/ExtensionBoundary.jsx+++ b/frontend/src/plugins/runtime/ExtensionBoundary.jsx@@ -1,12 +1,12 @@/**- * Per-extension error boundary + failure card (plan 25 Phase 2 #7, Decision 5).+ * Per-extension error boundary + failure card.** Fail soft, loudly: a runtime extension bundle that fails to load (integrity or* import error), or whose component throws at render, shows a contained card on* its own routes — never a white screen, never silent absence. The same failure* is surfaced on the Marketplace: the installed row shows a runtime load-state* badge (loaded / SDK-incompatible / failed) read from the loader's- * `getRuntimeLoadState`, with the error string in a popover (plan 32 #5).+ * `getRuntimeLoadState`, with the error string in a popover.*/import { Component } from 'react';import { Trans, useTranslation } from 'react-i18next';diff --git a/frontend/src/plugins/runtime/__tests__/sdkGate.test.mjs b/frontend/src/plugins/runtime/__tests__/sdkGate.test.mjsindex d974fa34..324945ca 100644--- a/frontend/src/plugins/runtime/__tests__/sdkGate.test.mjs+++ b/frontend/src/plugins/runtime/__tests__/sdkGate.test.mjs@@ -1,4 +1,4 @@-// Proving test for the load-time SDK gate (plan 32 Decision 1).+// Proving test for the load-time SDK gate.//// The gate is the pure half of the runtime loader's version check, split out so// it runs under plain node. This covers the refusal matrix: grace (no range),diff --git a/frontend/src/plugins/runtime/__tests__/sha256.test.mjs b/frontend/src/plugins/runtime/__tests__/sha256.test.mjsindex faf24280..aa81cff1 100644--- a/frontend/src/plugins/runtime/__tests__/sha256.test.mjs+++ b/frontend/src/plugins/runtime/__tests__/sha256.test.mjs@@ -1,5 +1,5 @@-// Proving test for the dependency-free SHA-256 + the digest seam (plan 32-// Decision 2). The HTTP-only panel path (pure-JS sha256) MUST compute the same+// Proving test for the dependency-free SHA-256 + the digest seam. The+// HTTP-only panel path (pure-JS sha256) MUST compute the same// digest as the secure-context path (crypto.subtle). This asserts the pure-JS// implementation against known vectors AND against Node's crypto for random// inputs, and asserts the digest seam agrees with the pure-JS hash.diff --git a/frontend/src/plugins/runtime/digest.js b/frontend/src/plugins/runtime/digest.jsindex bba12058..eec7eabb 100644--- a/frontend/src/plugins/runtime/digest.js+++ b/frontend/src/plugins/runtime/digest.js@@ -1,5 +1,5 @@/**- * Digest seam (plan 32 Decision 2) — the SINGLE place `crypto.subtle` is used.+ * Digest seam — the SINGLE place `crypto.subtle` is used.** `digestBytes()` returns the lowercase sha256 hex of a bundle's bytes,* choosing the implementation by context:diff --git a/frontend/src/plugins/runtime/loader.js b/frontend/src/plugins/runtime/loader.jsindex 760f47d4..aff7f9be 100644--- a/frontend/src/plugins/runtime/loader.js+++ b/frontend/src/plugins/runtime/loader.js@@ -1,5 +1,5 @@/**- * Runtime extension frontend loader (plan 25 Phase 2, Decision 1).+ * Runtime extension frontend loader.** For an installed extension that ships a prebuilt ESM bundle, the panel:* 1. fetches the bundle through the JWT-authed assets route (raw bytes),@@ -47,7 +47,7 @@ export function getRuntimeLoadState(slug) {}// Thrown when a bundle is refused BEFORE any bytes are fetched because its-// declared SDK range doesn't cover the panel's SDK version (plan 32 Decision 1).+// declared SDK range doesn't cover the panel's SDK version.// Carried as a distinct load state ('refused') so the Marketplace can tell an// SDK mismatch apart from an integrity/fetch failure.class SdkRefusedError extends Error {}@@ -59,7 +59,7 @@ export function isRuntimeFrontend(frontends, slug) {return Boolean(frontends && frontends[slug]);}-// Load-time SDK gate (plan 32 Decision 1). Refuse a bundle whose declared+// Load-time SDK gate. Refuse a bundle whose declared// `sdk_version` range doesn't cover the panel's SDK version, BEFORE fetching any// bytes — the failure card then explains the version gap instead of a cryptic// import error. A missing/blank range is a one-release grace: warn (dev) anddiff --git a/frontend/src/plugins/runtime/sdkGate.js b/frontend/src/plugins/runtime/sdkGate.jsindex ce52bf49..e629a7d3 100644--- a/frontend/src/plugins/runtime/sdkGate.js+++ b/frontend/src/plugins/runtime/sdkGate.js@@ -1,5 +1,5 @@/**- * Load-time SDK gate decision (plan 32 Decision 1) — the pure half of the+ * Load-time SDK gate decision — the pure half of the* runtime loader's version check, split out so it's unit-testable under plain* node (the loader itself touches `import.meta.env` and `crypto`).*diff --git a/frontend/src/plugins/runtime/sha256.js b/frontend/src/plugins/runtime/sha256.jsindex 78d4247a..46c602bf 100644--- a/frontend/src/plugins/runtime/sha256.js+++ b/frontend/src/plugins/runtime/sha256.js@@ -1,5 +1,5 @@/**- * Dependency-free SHA-256 (plan 32 Decision 2).+ * Dependency-free SHA-256.** The runtime loader verifies each bundle's sha256 against the install-recorded* hash. In a SECURE context the browser's `crypto.subtle` does this natively;diff --git a/frontend/src/plugins/runtime/vendorManifest.js b/frontend/src/plugins/runtime/vendorManifest.jsindex 2428ed91..0419201d 100644--- a/frontend/src/plugins/runtime/vendorManifest.js+++ b/frontend/src/plugins/runtime/vendorManifest.js@@ -1,6 +1,6 @@/*** The single list of modules a runtime-loaded extension resolves through the- * host (plan 25 Decision 2; plan 79 §SDK).+ * host.** Three things used to restate this list independently — the import map in* vite.config.js, the namespace capture in vendorShare.js, and one@@ -30,7 +30,7 @@ export const VENDOR_MODULES = [// i18next and react-i18next are shared for the same reason React is: an// extension bundling its own copy would get a SEPARATE, uninitialised// i18next, so every `t()` in that extension would silently render its- // English default forever — the failure mode plan 79 hit twice in core.+ // English default forever — the failure mode localization hit twice in core.{ specifier: 'i18next', file: 'i18next.mjs', exportsFrom: 'module' },{ specifier: 'react-i18next', file: 'react-i18next.mjs', exportsFrom: 'module' },{ specifier: 'serverkit-sdk', file: 'serverkit-sdk.mjs', exportsFrom: 'sdk' },diff --git a/frontend/src/plugins/runtime/vendorShare.js b/frontend/src/plugins/runtime/vendorShare.jsindex 71f7908d..01825670 100644--- a/frontend/src/plugins/runtime/vendorShare.js+++ b/frontend/src/plugins/runtime/vendorShare.js@@ -1,5 +1,5 @@/**- * Host vendor sharing for runtime-loaded extension bundles (plan 25 Decision 2).+ * Host vendor sharing for runtime-loaded extension bundles.** A runtime extension bundle externalizes the shared libraries (react,* react-dom, react/jsx-runtime, react-router-dom, i18next, react-i18next,diff --git a/frontend/src/plugins/sdk/index.js b/frontend/src/plugins/sdk/index.jsindex 31664cfe..99e1f33c 100644--- a/frontend/src/plugins/sdk/index.js+++ b/frontend/src/plugins/sdk/index.js@@ -45,7 +45,7 @@ export { api, default as defaultApi } from '../../services/api';// Design-system primitives — the sanctioned building blocks for plugin pages.// A plugin page should look like a core page: PageTopbar + KpiBand +// DataTable/ResourceList. Extensions previously deep-imported '@/components/ds'-// (still works, same modules); this is the blessed surface (Plan 20 Decision 4).+// (still works, same modules); this is the blessed surface.export {KpiBand,MetricCard,@@ -118,7 +118,7 @@ export {Outlet,} from 'react-router-dom';-// Layout + feedback primitives (plan 52 Phase 4 — the WordPress frontend+// Layout + feedback primitives (the WordPress frontend// relocation proved these out). Generic re-exports, same modules core pages// use; an extension page should be able to mirror a core page's chrome// (tab group, modal, confirm, empty/loading states) without deep imports.@@ -152,7 +152,7 @@ export { useTopbarActions } from '../../hooks/useTopbarActions';export { formatBytes } from '../../utils/formatBytes';export { timeAgo, formatRelativeTime, formatDuration } from '../../utils/time';-// Localization (plan 79). These are the HOST's singletons, not a parallel+// Localization. These are the HOST's singletons, not a parallel// extension i18n: `useTranslation`/`Trans` resolve against the panel's own// i18next instance (shared via vendorManifest), so an extension's copy follows// the user's language, plural rules and locale switch with no wiring of its@@ -173,7 +173,7 @@ export {formatNumber, formatPercent, formatList,} from '../../utils/intl';-// Generic page furniture + cross-feature embeds (plan 52 Phase 5 — the+// Generic page furniture + cross-feature embeds (the// WordPress runtime-ESM extraction proved these out). Two consumer classes:// - generic primitives any extension page may need (ErrorBoundary,// DangerZone, ResourceAdvisory, ResourceListPage, the logs drawer, and@@ -194,7 +194,7 @@ export { RepoProviderStrip } from '../../components/git/GitProviders';export { GIT_PROVIDERS, detectProvider } from '../../components/git/gitProviderData';export { default as ProtectionPanel } from '../../components/backups/ProtectionPanel';-// List-page chrome (1.4.0, plan 52 Phase 2 — the email/cloudflare-ops frontend+// List-page chrome (1.4.0 — the email/cloudflare-ops frontend// relocations proved these out). The full table kit a relocated list page// needs: the DataTable footer/toolbar pieces, the saved-view chrome from// ds/grid, the standalone-page layout, and the two table hooks. Same modulesdiff --git a/frontend/src/plugins/serverkit-gui/components/ServerGui.jsx b/frontend/src/plugins/serverkit-gui/components/ServerGui.jsxindex 5a7d2f50..78b33011 100644--- a/frontend/src/plugins/serverkit-gui/components/ServerGui.jsx+++ b/frontend/src/plugins/serverkit-gui/components/ServerGui.jsx@@ -1,5 +1,5 @@import { useEffect, useRef, useState, useCallback } from 'react';-// Imported from the SDK exactly as a third-party extension would (plan 79):+// Imported from the SDK exactly as a third-party extension would:// these resolve to the HOST's i18next instance and format door, so this// extension follows the panel's language and locale with no wiring of its own.import { useTranslation, useFormat } from 'serverkit-sdk';diff --git a/frontend/src/routes/__tests__/managedProfile.test.mjs b/frontend/src/routes/__tests__/managedProfile.test.mjsindex a16640d1..c1bb77d0 100644--- a/frontend/src/routes/__tests__/managedProfile.test.mjs+++ b/frontend/src/routes/__tests__/managedProfile.test.mjs@@ -11,7 +11,7 @@ import {} from '../../components/managedCapabilities.js';import { CORE_ROUTES } from '../routeManifest.js';-// The drift guard for the managed capability map (plan 25 §Risks): the mapping+// The drift guard for the managed capability map: the mapping// from capability to sidebar ids, routes and in-page controls lives in ONE// table (components/managedCapabilities.js, re-exported from sidebarItems.js),// and this test is what keeps it true as pages move. A failure here means thediff --git a/frontend/src/services/api/apps.js b/frontend/src/services/api/apps.jsindex 69cb48e8..0a94c510 100644--- a/frontend/src/services/api/apps.js+++ b/frontend/src/services/api/apps.js@@ -535,7 +535,7 @@ export async function getCurrentDeployment(appId) {return this.request(`/builds/apps/${appId}/current-deployment`);}-// Services an app uses (plan 86 §C4): storage (own bucket + scoped key),+// Services an app uses: storage (own bucket + scoped key),// cache and queue (env references to an installed engine).export async function getAppAttachments(appId) {return this.request(`/apps/${appId}/attachments`);@@ -556,7 +556,7 @@ export async function detachService(appId, attachmentId) {return this.request(`/apps/${appId}/attachments/${attachmentId}`, { method: 'DELETE' });}-// Opt-in PgBouncer beside an installed PostgreSQL (plan 86 §D1).+// Opt-in PgBouncer beside an installed PostgreSQL.export async function getAppPooler(appId) {return this.request(`/apps/${appId}/pooler`);}@@ -565,17 +565,17 @@ export async function setAppPooler(appId, enabled) {return this.request(`/apps/${appId}/pooler`, { method: 'PUT', body: { enabled } });}-// Rule-based bottleneck hints for an app (plan 86 §A5).+// Rule-based bottleneck hints for an app.export async function getAppHints(appId) {return this.request(`/apps/${appId}/hints`);}-// Long-cache fingerprinted assets in the vhost (plan 86 §B2).+// Long-cache fingerprinted assets in the vhost.export async function setImmutableAssets(appId, enabled) {return this.request(`/apps/${appId}/immutable-assets`, { method: 'PUT', body: { enabled } });}-// A/B slot deploys (plan 87): slot state + eligibility, the opt-in, and the+// A/B slot deploys: slot state + eligibility, the opt-in, and the// instant switch back to the standby.export async function getAppSlots(appId) {return this.request(`/apps/${appId}/slots`);diff --git a/frontend/src/services/api/backupProtection.js b/frontend/src/services/api/backupProtection.jsindex 033951c0..dc266023 100644--- a/frontend/src/services/api/backupProtection.js+++ b/frontend/src/services/api/backupProtection.js@@ -67,7 +67,7 @@ export async function deleteBackupRun(targetType, targetId, runId) {// Target types available right now (core set + extension-registered kinds,// e.g. wordpress_site only while the WordPress extension is installed). The// Protection panel / restore drawer read this instead of hardcoding type-// knowledge, so an absent extension means an absent type (plan 52 D4).+// knowledge, so an absent extension means an absent type.export async function getBackupTargetTypes() {return this.request('/backups/target-types');}diff --git a/frontend/src/services/api/client.js b/frontend/src/services/api/client.jsindex e0cad601..eef60a5c 100644--- a/frontend/src/services/api/client.js+++ b/frontend/src/services/api/client.js@@ -207,7 +207,7 @@ class ApiClient {try {fallback += `: ${new URL(response.url).pathname}`;} catch { /* keep the status-only message */ }- // Plan 79 F1: when the route names a machine `code`, the message+ // When the route names a machine `code`, the message// becomes translatable — `errors.<code>` with the server's own// English as the inline default, so an un-keyed code degrades to// exactly today's behaviour. The 257 `toast.error(err.message)`diff --git a/frontend/src/services/api/dashboards.js b/frontend/src/services/api/dashboards.jsindex 62c076a0..d207eef1 100644--- a/frontend/src/services/api/dashboards.js+++ b/frontend/src/services/api/dashboards.js@@ -1,4 +1,4 @@-// Dashboard board persistence (plan 62).+// Dashboard board persistence.// A board is one dashboard tab: { id, slug, name, icon, position, widgets }.// Boards are per-user — the backend scopes every call to the caller, and the// first getDashboards() of a new account seeds the shipped default boards.diff --git a/frontend/src/services/api/dbProcesses.js b/frontend/src/services/api/dbProcesses.jsindex 47ce5884..3a67a85f 100644--- a/frontend/src/services/api/dbProcesses.js+++ b/frontend/src/services/api/dbProcesses.js@@ -25,8 +25,8 @@ export async function killDockerDbProcess(container, pid, type, user = null, pas});}-// Top queries + connection / cache-hit gauges for a Docker database container-// (plan 86 §A3), and the switch PostgreSQL needs before it records statements.+// Top queries + connection / cache-hit gauges for a Docker database container,+// and the switch PostgreSQL needs before it records statements.export async function getDockerDbInsights(container, type, user = null, password = null) {const headers = password ? { 'X-DB-Password': password } : {};const params = new URLSearchParams({ type: type || 'mysql' });diff --git a/frontend/src/services/api/deploymentJobs.js b/frontend/src/services/api/deploymentJobs.jsindex e00691bd..5e865904 100644--- a/frontend/src/services/api/deploymentJobs.js+++ b/frontend/src/services/api/deploymentJobs.js@@ -21,8 +21,8 @@ export async function getDeploymentJobLogs(jobId, afterId = null) {return this.request(`/deployment-jobs/${jobId}/logs${suffix}`);}-// Retry a failed deployment job — clones it and enqueues a fresh run (plan 51-// D8). Returns { job_id, job } for the new job so the console can swap to it.+// Retry a failed deployment job — clones it and enqueues a fresh run. Returns+// { job_id, job } for the new job so the console can swap to it.export async function retryDeploymentJob(jobId) {return this.request(`/deployment-jobs/${jobId}/retry`, { method: 'POST' });}@@ -34,7 +34,7 @@ export async function submitRecipeHandoff(jobId, stepId, value) {);}-// Simulated deployments (plan 51.5 dev tool). The GET 404s when the backend+// Simulated deployments (dev tool). The GET 404s when the backend// gate (DEMO_DEPLOYS_ENABLED) is off — callers treat that as "hidden".export async function getDeploySimulateInfo() {return this.request('/deployment-jobs/simulate');diff --git a/frontend/src/services/api/dnsCutover.js b/frontend/src/services/api/dnsCutover.jsindex f60a9d50..1ba1eac0 100644--- a/frontend/src/services/api/dnsCutover.js+++ b/frontend/src/services/api/dnsCutover.js@@ -1,6 +1,5 @@// Reversible DNS cutover (/api/v1/dns-cutover) — snapshot a domain's records-// before a migration cutover so the switch can be reverted (plan 27 #13,-// plan 31 #1/#2/#4).+// before a migration cutover so the switch can be reverted.export async function getCutoverTtlGuidance(records) {return this.request('/dns-cutover/ttl-guidance', {@@ -9,7 +8,7 @@ export async function getCutoverTtlGuidance(records) {});}-// Server-sourced snapshot (plan 31 #2): the panel reads live records from the+// Server-sourced snapshot: the panel reads live records from the// provider itself; the client may only pass `names` to filter which record// names to include (never the record data). Requires a connected provider zone.export async function snapshotDnsForCutover(domain, providerZoneId, provider = null, names = null) {@@ -28,7 +27,7 @@ export async function getCutoverSnapshot(snapshotId) {return this.request(`/dns-cutover/snapshots/${snapshotId}`);}-// Perform (or dry-run) a cutover (plan 31 #1). `dryRun: true` returns the exact+// Perform (or dry-run) a cutover. `dryRun: true` returns the exact// provider ops (create/update, old→new) without writing and needs no provider.export async function performDnsCutover(snapshotId, target, { recordTypes = ['A'], dryRun = false } = {}) {return this.request('/dns-cutover/cutover', {@@ -37,7 +36,7 @@ export async function performDnsCutover(snapshotId, target, { recordTypes = ['A'});}-// Post-cutover resolution check across public resolvers (plan 31 #1).+// Post-cutover resolution check across public resolvers.export async function verifyDnsCutover(domain, { recordType = 'A', expected = null, snapshotId = null } = {}) {return this.request('/dns-cutover/verify', {method: 'POST',diff --git a/frontend/src/services/api/doctor.js b/frontend/src/services/api/doctor.jsindex 66d6c3ae..44c3ac2f 100644--- a/frontend/src/services/api/doctor.js+++ b/frontend/src/services/api/doctor.js@@ -16,7 +16,7 @@ export async function repairDoctorItems(items) {});}-// Fleet doctor (plan 26) — the per-server health sweep merged across every+// Fleet doctor — the per-server health sweep merged across every// connected agent. getFleetDoctorReport returns { report: { ran_at, servers } };// runFleetSweep enqueues the sweep job (fan-out runs off the request thread)// and returns { job_id }.diff --git a/frontend/src/services/api/errorCodes.js b/frontend/src/services/api/errorCodes.jsindex 9cb36c13..5c5816d5 100644--- a/frontend/src/services/api/errorCodes.js+++ b/frontend/src/services/api/errorCodes.js@@ -1,14 +1,14 @@import { t } from '../../i18n/t.js';/**- * Translate a server error by its machine code (plan 79 F1).+ * Translate a server error by its machine code.** The problem: 257 render sites do `toast.error(err.message)`, showing a* string the backend authored in English. There is no key to translate* against, and the frontend cannot invent one — the same prose comes from* several routes and a route can change its wording.*- * The backend already answers this. Plan 76 milestone B's typed-error door+ * The backend already answers this. The typed-error door* (`app/exceptions.py` + the global handler) emits a stable body:** { "error": "Invalid username/email or password",@@ -23,9 +23,9 @@ import { t } from '../../i18n/t.js';* else falls through to the server's English, which is exactly today's* behaviour.*- * WHICH CODES: plan 76 §C's 23 status-from-prose sites are gone (the status+ * WHICH CODES: the 23 status-from-prose sites are gone (the status* sniffing ratchet is at 0), so translating a message can no longer change a- * status. Beyond auth, plan 88 §C added the common families, each minted by a+ * status. Beyond auth, later work added the common families, each minted by a* factory in `backend/app/exceptions.py` with ONE fixed message per code:** not_found.<resource> "<Resource> not found"diff --git a/frontend/src/services/api/files.js b/frontend/src/services/api/files.jsindex 591bfd20..ae6b1a29 100644--- a/frontend/src/services/api/files.js+++ b/frontend/src/services/api/files.js@@ -273,7 +273,7 @@ export async function testFTPConnection(host = 'localhost', port = 21, username}// The Gitea self-host surface (server lifecycle + repo browsing) moved into-// the serverkit-git extension with the Git page (plan 52 Phase 6) - its own+// the serverkit-git extension with the Git page - its own// client lives there. Core keeps the webhook + deployment endpoints below// (they ARE the deploy pipeline) and three fail-soft Gitea aliases the// app-creation repo pickers probe; those return 404 when the extension isdiff --git a/frontend/src/services/api/imports.js b/frontend/src/services/api/imports.jsindex 62c4b64f..e25ae35d 100644--- a/frontend/src/services/api/imports.js+++ b/frontend/src/services/api/imports.js@@ -21,7 +21,7 @@ export async function analyzeImport(importId) {return this.request(`/imports/${importId}/analyze`, { method: 'POST' });}-// SSH-source preflight (plan 31 #8): probe a reachable box before pulling it.+// SSH-source preflight: probe a reachable box before pulling it.// Returns {reachable, docroot_exists, entry_count, detected_stack, sample:[...]}// or 501 {error, code:'LINUX_ONLY'} off a Linux panel host (e.g. Windows dev).export async function probeSshImportSource(source) {diff --git a/frontend/src/services/api/plugins.js b/frontend/src/services/api/plugins.jsindex f13e9620..ace3fdef 100644--- a/frontend/src/services/api/plugins.js+++ b/frontend/src/services/api/plugins.js@@ -143,7 +143,7 @@ export async function updatePluginConfig(pluginId, config) {}// Declared vs actually-observed permission use for one installed extension-// (plan 55, admin-only):+// (admin-only):// { slug, permissions: [ { permission, declared, observable, used, uses,// first_used_at, last_used_at, denied? } ],// unused_observable, undeclared_attempts, observable_count,@@ -160,7 +160,7 @@ export async function getPluginPermissions(pluginId) {}// Python dependencies an install declined to pip-install for one extension-// (plan 55, admin-only):+// (admin-only):// { slug, pending, pip_enabled, env_var, path, content, packages, truncated }// `pending: true` means the packages were NOT installed and the requirements// file is sitting next to the extension. Read-only — there is no install routediff --git a/frontend/src/services/api/search.js b/frontend/src/services/api/search.jsindex 2420c7cb..eecd48b0 100644--- a/frontend/src/services/api/search.js+++ b/frontend/src/services/api/search.js@@ -1,4 +1,4 @@-// Unified entity omnisearch (plan 41, Phase 4).+// Unified entity omnisearch.export async function search(q) {const response = await this.request(`/search?q=${encodeURIComponent(q)}`);return normalizeSearchResponse(response);diff --git a/frontend/src/services/api/security.js b/frontend/src/services/api/security.jsindex 04e06058..ad17e77e 100644--- a/frontend/src/services/api/security.js+++ b/frontend/src/services/api/security.js@@ -1,7 +1,7 @@// Firewall, SSL certificates, file integrity, SSH keys, IP lists and the// security audit — the core security surfaces. The install-gated tool// clients (ClamAV/YARA/quarantine, fail2ban, Lynis, auto-updates) moved into-// their security extensions with their tabs (plan 47 Ph3b-4).+// their security extensions with their tabs.// Firewall endpointsexport async function getFirewallStatus() {diff --git a/frontend/src/services/api/survey.js b/frontend/src/services/api/survey.jsindex 7de6ae72..ac06751c 100644--- a/frontend/src/services/api/survey.js+++ b/frontend/src/services/api/survey.js@@ -12,9 +12,9 @@ export async function runServerSurvey(serverId) {}// Switch a server between 'managed' and 'observed' adoption modes. Optionally-// toggle the observed-mode agent:update break-glass (plan 31 #10). The response+// toggle the observed-mode agent:update break-glass. The response// carries `observed_blocked_count` — how many commands the Observe guard has-// refused on this server (plan 31 #11).+// refused on this server.export async function setServerManagementMode(serverId, mode, allowAgentUpdateObserved = undefined) {const body = { mode };if (allowAgentUpdateObserved !== undefined) {@@ -27,7 +27,7 @@ export async function setServerManagementMode(serverId, mode, allowAgentUpdateOb}// Observe-mode status: current mode, the agent:update break-glass flag, and the-// count of commands the Observe guard has blocked (plan 31 #10/#11).+// count of commands the Observe guard has blocked.export async function getServerObservedStatus(serverId) {return this.request(`/servers/${serverId}/observed-status`);}diff --git a/frontend/src/services/api/system.js b/frontend/src/services/api/system.jsindex 7e0e05a4..ebb4ea10 100644--- a/frontend/src/services/api/system.js+++ b/frontend/src/services/api/system.js@@ -127,7 +127,7 @@ export async function checkUpdate() {return this.request('/system/check-update');}-// ServerKit Cloud connect state and the managed presentation policy (plan 25).+// ServerKit Cloud connect state and the managed presentation policy.// Both are admin-only on the backend; callers treat a refusal as "no profile".export async function getConnectStatus() {return this.request('/connect/status');@@ -799,7 +799,7 @@ export async function testUserNotification() {// Email Server management moved into the serverkit-email extension// (builtin-extensions/serverkit-email/frontend/services/email.js) with the-// Email page — plan 52 Phase 2. Core keeps only the two email-adjacent+// Email page. Core keeps only the two email-adjacent// surfaces that core Settings → Connections renders: the DNS-provider// connections below (served by the core dns_providers blueprint, which owns// the historical /email/dns-providers prefix) and the outbound relay tilediff --git a/frontend/src/services/api/themes.js b/frontend/src/services/api/themes.jsindex dbf198ee..65fed141 100644--- a/frontend/src/services/api/themes.js+++ b/frontend/src/services/api/themes.js@@ -1,4 +1,4 @@-// Themes platform API methods (plan 60).+// Themes platform API methods.// A theme is data (a validated token map), so these are plain JSON calls — no// zip upload, no checksum dance.diff --git a/frontend/src/services/socket.js b/frontend/src/services/socket.jsindex 3d0afacb..7aa38e5d 100644--- a/frontend/src/services/socket.js+++ b/frontend/src/services/socket.js@@ -69,7 +69,7 @@ class SocketService {this.emit('notification', data);});- // Deploy Console live push (plan 51): batched log lines + status+ // Deploy Console live push: batched log lines + status// summaries for a deployment job. Accelerator over after_id polling.this.socket.on('deploy_log', (data) => {this.emit('deploy_log', data);diff --git a/frontend/src/styles/_mixins.scss b/frontend/src/styles/_mixins.scssindex b691a501..9284fc7d 100644--- a/frontend/src/styles/_mixins.scss+++ b/frontend/src/styles/_mixins.scss@@ -228,7 +228,7 @@// ============================================-// STATUS VARIANT (plan 77 D4)+// STATUS VARIANT// ============================================// The ONE shape for coloring a status-bearing element. Pages position the// element and pass tones through this door; a convention change (adding adiff --git a/frontend/src/styles/_variables.scss b/frontend/src/styles/_variables.scssindex 4701b405..70a97dc7 100644--- a/frontend/src/styles/_variables.scss+++ b/frontend/src/styles/_variables.scss@@ -91,7 +91,7 @@ $accent-bg-soft: var(--accent-bg-soft);// COLORS - Semantic// --------------------------------------------// Redesign "infra console" semantic palette. $success/$warning/$danger/$info-// are var()-backed so runtime themes (plan 60: --green/--amber/--red/--cyan)+// are var()-backed so runtime themes (--green/--amber/--red/--cyan)// recolor them; the *-raw hex twins feed SCSS compile-time functions// (fade()/rgba()/darken()) that can't operate on a var().$success-raw: #3ddc97;@@ -146,7 +146,7 @@ $color-star: #f59e0b;// --------------------------------------------// TYPOGRAPHY// ---------------------------------------------// var()-backed so runtime themes (plan 60: --sans/--mono) can swap the stacks.+// var()-backed so runtime themes (--sans/--mono) can swap the stacks.$font-main: var(--sans, 'IBM Plex Sans', system-ui, -apple-system, BlinkMacSystemFont, sans-serif);$font-mono: var(--mono, 'IBM Plex Mono', ui-monospace, 'SF Mono', 'JetBrains Mono', Menlo, monospace);diff --git a/frontend/src/styles/components/_cards.scss b/frontend/src/styles/components/_cards.scssindex 53f78503..515ee6ee 100644--- a/frontend/src/styles/components/_cards.scss+++ b/frontend/src/styles/components/_cards.scss@@ -177,7 +177,7 @@.stat-strip__value { font-size: $text-md; }}-// Legacy `.stats-grid` / `.stat-card` KPI tile system removed (Plan 20 #20) —+// Legacy `.stats-grid` / `.stat-card` KPI tile system removed —// pages use the shared KpiBand primitive (`.sk-kpiband`). `.stat-icon` below is// kept: it is a standalone icon chip still used by StyleGuide demos..stat-icon {@@ -233,7 +233,7 @@}// Legacy `.stat-content` / `.stat-label` / `.stat-value` / `.stat-suffix` /-// `.stat-detail` / `.stat-card--clickable` removed (Plan 20 #20) — superseded by+// `.stat-detail` / `.stat-card--clickable` removed — superseded by// the MetricCard tile (`.sk-kpi`) inside KpiBand.// Progress bardiff --git a/frontend/src/styles/components/_command-palette.scss b/frontend/src/styles/components/_command-palette.scssindex 8f4ca7d0..3278206f 100644--- a/frontend/src/styles/components/_command-palette.scss+++ b/frontend/src/styles/components/_command-palette.scss@@ -137,7 +137,7 @@}// ---------------------------------------------// Palette v2 (plan 41): omnisearch item rows rendered inside the cmdk+// Palette v2: omnisearch item rows rendered inside the cmdk// .ui-command-item. Icon + label/sublabel body + optional external marker.// --------------------------------------------.command-palette__item-icon {@@ -301,7 +301,7 @@}// ---------------------------------------------// Settings deep-link flash (plan 41, Phase 2): a palette result lands on the+// Settings deep-link flash: a palette result lands on the// exact card via ?focus=setting:<id>; useSettingFocus scrolls it into view and// adds .is-setting-focused for ~2s. Token-based ring + brief background wash.// --------------------------------------------diff --git a/frontend/src/styles/components/_dashboard-widgets.scss b/frontend/src/styles/components/_dashboard-widgets.scssindex fbc84b23..7d4daaff 100644--- a/frontend/src/styles/components/_dashboard-widgets.scss+++ b/frontend/src/styles/components/_dashboard-widgets.scss@@ -1,5 +1,5 @@// ============================================================-// DASHBOARD WIDGET GRID (plan 62)+// DASHBOARD WIDGET GRID// ============================================================// Everything the configurable dashboard needs: the board bar, the placement// grid, one widget's chrome, the 13 core widget bodies, the "add a widget"diff --git a/frontend/src/styles/components/_design-system.scss b/frontend/src/styles/components/_design-system.scssindex a9d2d85e..b250dbdb 100644--- a/frontend/src/styles/components/_design-system.scss+++ b/frontend/src/styles/components/_design-system.scss@@ -219,7 +219,7 @@ $sk-tones: ('accent', 'green', 'cyan', 'amber', 'red', 'violet');}// -------------------------------------------------------------// KpiBand — the one responsive grid wrapper for MetricCard tiles (plan 20).+// KpiBand — the one responsive grid wrapper for MetricCard tiles.// `--kpi-cols` is set inline by the component; tiles collapse to fewer columns// as the viewport narrows so every summary strip shares one collapse behaviour.// ------------------------------------------------------------diff --git a/frontend/src/styles/components/_extensions.scss b/frontend/src/styles/components/_extensions.scssindex 96930d37..f79fee87 100644--- a/frontend/src/styles/components/_extensions.scss+++ b/frontend/src/styles/components/_extensions.scss@@ -1,4 +1,4 @@-// Runtime-extension failure card (plan 25 Phase 2 #7). Rendered on an+// Runtime-extension failure card. Rendered on an// extension's routes when its bundle fails to load or its component crashes.// Deliberately dependency-free styling — it must render even when the extension// (or the design system it leans on) is the thing that broke.diff --git a/frontend/src/styles/components/_managed-card.scss b/frontend/src/styles/components/_managed-card.scssindex 563e9e18..d0fabbf7 100644--- a/frontend/src/styles/components/_managed-card.scss+++ b/frontend/src/styles/components/_managed-card.scss@@ -1,4 +1,4 @@-// Managed card + lapsed-profile banner (plan 25). What a held capability's+// Managed card + lapsed-profile banner. What a held capability's// page shows instead of its content, and the one-line notice when a policy// lapsed and the full panel returned.diff --git a/frontend/src/styles/components/_notifications.scss b/frontend/src/styles/components/_notifications.scssindex 47abb117..cfa9de05 100644--- a/frontend/src/styles/components/_notifications.scss+++ b/frontend/src/styles/components/_notifications.scss@@ -10,7 +10,7 @@}// "Email bouncing" warning shown in the Email Settings card when a user's-// address is auto-muted after repeated hard bounces (plan 33 Phase 4).+// address is auto-muted after repeated hard bounces..notif-bounce-warning {display: flex;align-items: center;@@ -170,7 +170,7 @@}// ============================================-// PER-EVENT OVERRIDE MATRIX + ORG DEFAULTS (plan 24 Phase 2)+// PER-EVENT OVERRIDE MATRIX + ORG DEFAULTS// ============================================.notif-event-matrix {@@ -343,7 +343,7 @@}}-// Email digest cadence selector (plan 24 Phase 3)+// Email digest cadence selector.notif-digest-options {display: flex;gap: $space-3;diff --git a/frontend/src/styles/components/_staging-banner.scss b/frontend/src/styles/components/_staging-banner.scssindex a79a160d..9c821434 100644--- a/frontend/src/styles/components/_staging-banner.scss+++ b/frontend/src/styles/components/_staging-banner.scss@@ -1,4 +1,4 @@-// STAGING banner (plan 37 testbed)+// STAGING banner// Full-width amber strip pinned to the very top of the app shell. Only shown on// the staging instance (backend /system/health echoes `staging:true`). Uses the// theme-agnostic $warning* tokens so it reads clearly in light and dark themes,diff --git a/frontend/src/styles/components/_uptime.scss b/frontend/src/styles/components/_uptime.scssindex d47bce5f..26138ab6 100644--- a/frontend/src/styles/components/_uptime.scss+++ b/frontend/src/styles/components/_uptime.scss@@ -304,7 +304,7 @@}}-// Legacy `.uptime-stats-grid` (double-defined) removed (Plan 20 #21) — unused;+// Legacy `.uptime-stats-grid` (double-defined) removed — unused;// summary metric grids use the KpiBand primitive (`.sk-kpiband`)..uptime-stat {display: flex;diff --git a/frontend/src/styles/layout/_grid.scss b/frontend/src/styles/layout/_grid.scssindex 8c435e23..d4cb2377 100644--- a/frontend/src/styles/layout/_grid.scss+++ b/frontend/src/styles/layout/_grid.scss@@ -2,7 +2,7 @@// GRID LAYOUTS// ============================================-// Legacy `.stats-strip` 4-column grid removed (Plan 20 #20) — unused; pages use+// Legacy `.stats-strip` 4-column grid removed — unused; pages use// the KpiBand primitive (`.sk-kpiband`) for summary metric grids.// Dashboard grid (auto-fit cards)diff --git a/frontend/src/styles/main.scss b/frontend/src/styles/main.scssindex 0f2abf57..267b2008 100644--- a/frontend/src/styles/main.scss+++ b/frontend/src/styles/main.scss@@ -136,8 +136,8 @@@import 'pages/_server-survey';@import 'pages/_downloads';@import 'pages/_ssl';-// WordPress styles moved into the serverkit-wordpress extension (plan 52-// Phase 4) — its synced bundle imports them through its own module graph.+// WordPress styles moved into the serverkit-wordpress extension — its synced+// bundle imports them through its own module graph.@import 'pages/_setup-wizard';@import 'pages/_migration-wizard';@import 'pages/_import-wizard';diff --git a/frontend/src/styles/pages/_applications.scss b/frontend/src/styles/pages/_applications.scssindex c2fc1e84..2787fd30 100644--- a/frontend/src/styles/pages/_applications.scss+++ b/frontend/src/styles/pages/_applications.scss@@ -1553,7 +1553,7 @@}}-// Micro-cache panel (plan 86 §B3): TTL input + save, hit-ratio readout.+// Micro-cache panel: TTL input + save, hit-ratio readout..micro-cache {&__ttl {display: flex;diff --git a/frontend/src/styles/pages/_bandwidth.scss b/frontend/src/styles/pages/_bandwidth.scssindex 419a7a9d..fcb6d8dc 100644--- a/frontend/src/styles/pages/_bandwidth.scss+++ b/frontend/src/styles/pages/_bandwidth.scss@@ -83,7 +83,7 @@}}-// Service detail Overview: Attached services card (plan 86 §C4).+// Service detail Overview: Attached services card.// Component: service-detail/AttachmentsCard..attachments {&__list {@@ -151,7 +151,7 @@}}-// Service detail Overview: Connection pooling card (plan 86 §D1).+// Service detail Overview: Connection pooling card.// Component: service-detail/PoolerCard..pooler {&__hint,@@ -164,7 +164,7 @@&__tradeoff { color: var(--text-faint); }}-// Service detail Overview: bottleneck hints (plan 86 §A5).+// Service detail Overview: bottleneck hints.// Component: service-detail/HintsCard..hints {&__window {@@ -217,7 +217,7 @@}}-// Service detail Overview: A/B slot deploys (plan 87 §F).+// Service detail Overview: A/B slot deploys.// Component: service-detail/SlotsCard..slots-card {&__slots {@@ -288,7 +288,7 @@}}-// Settings: the compose data-split preview (plan 87 §C).+// Settings: the compose data-split preview.// Component: apps/SlotDeploysPanel..slot-split {&__downtime {diff --git a/frontend/src/styles/pages/_coexistence.scss b/frontend/src/styles/pages/_coexistence.scssindex a13304c9..d5350bec 100644--- a/frontend/src/styles/pages/_coexistence.scss+++ b/frontend/src/styles/pages/_coexistence.scss@@ -1,4 +1,4 @@-// "Running alongside another panel" page (plan 27 #15).+// "Running alongside another panel" page..coexistence {display: flex;diff --git a/frontend/src/styles/pages/_cutover.scss b/frontend/src/styles/pages/_cutover.scssindex 8e6b7246..961f3f92 100644--- a/frontend/src/styles/pages/_cutover.scss+++ b/frontend/src/styles/pages/_cutover.scss@@ -1,5 +1,5 @@// ============================================-// DNS CUTOVER (reversible per-domain repoint — plan 31 #5/#6)+// DNS CUTOVER (reversible per-domain repoint)// Slide-over launched from /domains and the Import wizard. Mirrors the// import-wizard idiom (stepper + callouts + compact tables).// ============================================diff --git a/frontend/src/styles/pages/_db-tuner.scss b/frontend/src/styles/pages/_db-tuner.scssindex fd3cc5fd..8d390118 100644--- a/frontend/src/styles/pages/_db-tuner.scss+++ b/frontend/src/styles/pages/_db-tuner.scss@@ -129,7 +129,7 @@}}-// Database Explorer: Insights tab (plan 86 §A3).+// Database Explorer: Insights tab.// Component: databases/InsightsPanel..dbx-insights {padding: $space-4;diff --git a/frontend/src/styles/pages/_deploy-console.scss b/frontend/src/styles/pages/_deploy-console.scssindex 5b0a214c..ded575ef 100644--- a/frontend/src/styles/pages/_deploy-console.scss+++ b/frontend/src/styles/pages/_deploy-console.scss@@ -1,6 +1,6 @@// ============================================// DEPLOY CONSOLE (/deployments/:jobId)-// The signature "watch it deploy live" full-page console (plan 51).+// The signature "watch it deploy live" full-page console.// ============================================// Console log-level colors (mirrors the terminal/logs treatment).@@ -86,7 +86,7 @@ $dc-surface-line: rgba(255, 255, 255, 0.04);&--succeeded { @include status-variant(var(--green), var(--green-bg)); }&--failed { @include status-variant(var(--red), var(--red-bg)); }- // Demo/simulated jobs (plan 51.5): visually distinct from status pills.+ // Demo/simulated jobs: visually distinct from status pills.&--demo {background: transparent;color: $text-tertiary;@@ -613,7 +613,7 @@ $dc-surface-line: rgba(255, 255, 255, 0.04);to { transform: rotate(360deg); }}-// ---- log sections, chips and match navigation (plan 51.6 console parity) ----+// ---- log sections, chips and match navigation (console parity) ----.deploy-console {// Error / warning counts in the toolbar. They read as a summary first and// filter second, so they stay visible even when a filter is off.diff --git a/frontend/src/styles/pages/_deployments.scss b/frontend/src/styles/pages/_deployments.scssindex 829f1ef8..310ff883 100644--- a/frontend/src/styles/pages/_deployments.scss+++ b/frontend/src/styles/pages/_deployments.scss@@ -7,7 +7,7 @@// ============================================.deployments-page {- // Full width like every list (plan 89); the Deploy cell takes the spare+ // Full width like every list; the Deploy cell takes the spare// width, so a row's timing columns stay together at the right edge.// Target / Took / Started are short and fixed, but they sit beside a Deploydiff --git a/frontend/src/styles/pages/_doctor.scss b/frontend/src/styles/pages/_doctor.scssindex 6c563daa..02965769 100644--- a/frontend/src/styles/pages/_doctor.scss+++ b/frontend/src/styles/pages/_doctor.scss@@ -176,7 +176,7 @@}// ============================================-// Fleet doctor (plan 26) — per-server sweep switcher + server groups.+// Fleet doctor — per-server sweep switcher + server groups.// ============================================.doctor-panel__switcher {diff --git a/frontend/src/styles/pages/_fleet-monitor.scss b/frontend/src/styles/pages/_fleet-monitor.scssindex e72d3dbe..cb2e7244 100644--- a/frontend/src/styles/pages/_fleet-monitor.scss+++ b/frontend/src/styles/pages/_fleet-monitor.scss@@ -74,7 +74,7 @@// read-only view of the same numbers the Host health cards on /monitoring now// show, and those cards are clickable — they re-scope the page to that server.-// Fleet doctor rollup card (plan 26) — checks-by-status per server on the+// Fleet doctor rollup card — checks-by-status per server on the// Agent Fleet dashboard, consuming the same rows as the Doctor panel..fleet-doctor-rollup {margin-bottom: $space-4;diff --git a/frontend/src/styles/pages/_jobs.scss b/frontend/src/styles/pages/_jobs.scssindex 6d86b200..07aba0f6 100644--- a/frontend/src/styles/pages/_jobs.scss+++ b/frontend/src/styles/pages/_jobs.scss@@ -1,4 +1,4 @@-// Jobs page (plan 39) — host-idiom table-with-search, the /servers–/domains+// Jobs page — host-idiom table-with-search, the /servers–/domains// pattern. Most weight is carried by shared primitives: .sk-dtable (DataTable),// .sk-kpiband (KpiBand), .sk-seg (SegControl) and the global .search-box. This// file only lays out the page shell, the command bar, the scheduled-jobsdiff --git a/frontend/src/styles/pages/_marketplace.scss b/frontend/src/styles/pages/_marketplace.scssindex d478ee65..96108c3b 100644--- a/frontend/src/styles/pages/_marketplace.scss+++ b/frontend/src/styles/pages/_marketplace.scss@@ -585,7 +585,7 @@line-height: $line-height-normal;}- // Signature verdict explainer under the description (plan 55): plain for+ // Signature verdict explainer under the description: plain for// unsigned / unknown-publisher, red when the signature failed to verify.&__sig-note {margin: 0;@@ -691,7 +691,7 @@}// Read-only permissions + pending-dependencies dialog for an installed-// extension (plan 55 tasks 6+7). Rows are prose-first on purpose: the+// extension (tasks 6+7). Rows are prose-first on purpose: the// distinction between "the gate saw nothing" and "there is no gate" only// survives if each row can say it in a sentence, so nothing here compresses// a permission down to a bare chip.diff --git a/frontend/src/styles/pages/_new-service.scss b/frontend/src/styles/pages/_new-service.scssindex d4d73ead..2fece227 100644--- a/frontend/src/styles/pages/_new-service.scss+++ b/frontend/src/styles/pages/_new-service.scss@@ -1,5 +1,5 @@// ============================================-// NEW SERVICE PAGE (plan 43 — three-step wizard)+// NEW SERVICE PAGE (three-step wizard)// A slim stepper header over one centered column (~760px). The right rail of the// old form-wall is gone; only the review step has real content. Sub-component// blocks (repo list, template rows, manifest card, fields) are shared acrossdiff --git a/frontend/src/styles/pages/_notification-center.scss b/frontend/src/styles/pages/_notification-center.scssindex 01487ca0..60aecf08 100644--- a/frontend/src/styles/pages/_notification-center.scss+++ b/frontend/src/styles/pages/_notification-center.scss@@ -331,7 +331,7 @@.sk-eprov__grid { grid-template-columns: 1fr; }}-// ── Deep links + history filters (plan 24 Phase 5) ──+// ── Deep links + history filters ──.sk-notif-page__chips {display: flex;flex-wrap: wrap;diff --git a/frontend/src/styles/pages/_server-survey.scss b/frontend/src/styles/pages/_server-survey.scssindex c626425d..1018bd56 100644--- a/frontend/src/styles/pages/_server-survey.scss+++ b/frontend/src/styles/pages/_server-survey.scss@@ -1,4 +1,4 @@-// Survey tab (plan 27) — the read-only Server Map on server detail.+// Survey tab — the read-only Server Map on server detail..survey-tab {display: flex;diff --git a/frontend/src/styles/pages/_settings.scss b/frontend/src/styles/pages/_settings.scssindex c1fed6a8..5295da3b 100644--- a/frontend/src/styles/pages/_settings.scss+++ b/frontend/src/styles/pages/_settings.scss@@ -1380,7 +1380,7 @@}// ============================================-// THEME GALLERY (plan 60 — community themes)+// THEME GALLERY (community themes)// ============================================.theme-gallery-header {diff --git a/frontend/src/styles/pages/_setup-wizard.scss b/frontend/src/styles/pages/_setup-wizard.scssindex 2d5b8aa0..37a8c87d 100644--- a/frontend/src/styles/pages/_setup-wizard.scss+++ b/frontend/src/styles/pages/_setup-wizard.scss@@ -646,7 +646,7 @@}// ---------------------------------------------// Recommended extensions — install checkboxes (plan 47)+// Recommended extensions — install checkboxes// --------------------------------------------.recommendation-hint {margin: 0 0 $space-3;diff --git a/frontend/src/styles/pages/_storage.scss b/frontend/src/styles/pages/_storage.scssindex 1216ba05..8540ab85 100644--- a/frontend/src/styles/pages/_storage.scss+++ b/frontend/src/styles/pages/_storage.scss@@ -1,4 +1,4 @@-// Settings → Storage (plan 85 §D1/§D2): where the panel host's disk goes,+// Settings → Storage: where the panel host's disk goes,// the rollback slot, and the retention windows that bound ServerKit's share.// Card/row chrome comes from _settings.scss; only what is specific lives here.diff --git a/frontend/src/utils/applySkin.js b/frontend/src/utils/applySkin.jsindex f911acb5..3caca64c 100644--- a/frontend/src/utils/applySkin.js+++ b/frontend/src/utils/applySkin.js@@ -1,4 +1,4 @@-// Runtime skin applier (plan 60).+// Runtime skin applier.//// A "skin" is a theme's validated token map applied on top of the stock// stylesheet at runtime. We set each canonical token (plus its legacy aliases)diff --git a/frontend/src/utils/formatBytes.js b/frontend/src/utils/formatBytes.jsindex 3cd25904..f4df06f3 100644--- a/frontend/src/utils/formatBytes.js+++ b/frontend/src/utils/formatBytes.js@@ -45,7 +45,7 @@ export function formatBytes(bytes, options = {}) {// Whole-byte values never need decimals.const places = exponent === 0 ? 0 : decimals;- // Plan 79 §C: through the format door rather than toFixed + a regex trim.+ // Through the format door rather than toFixed + a regex trim.// `maximumFractionDigits` drops trailing zeros for free ("1.0" -> "1",// "1.50" -> "1.5") AND uses the locale's decimal separator, which the// string-trim could not: a Spanish panel showed "1.5 KB" where every otherdiff --git a/frontend/src/utils/formatNumber.js b/frontend/src/utils/formatNumber.jsindex 147fa65a..aa24d0d3 100644--- a/frontend/src/utils/formatNumber.js+++ b/frontend/src/utils/formatNumber.js@@ -7,7 +7,7 @@// returned unchanged, letting callers pass placeholders like an em dash// straight through.//-// Plan 79 §C: both used to build `new Intl.NumberFormat('en')` at module load+// Both used to build `new Intl.NumberFormat('en')` at module load// -- a hardcoded locale AND a formatter that could never follow a switch.// They now delegate to the format door.diff --git a/frontend/src/utils/intl.js b/frontend/src/utils/intl.jsindex 9e45514d..f65f8891 100644--- a/frontend/src/utils/intl.js+++ b/frontend/src/utils/intl.js@@ -1,4 +1,4 @@-// Plan 79 §C — the one locale-aware formatting door.+// The one locale-aware formatting door.//// Before this, five util files formatted things for humans and none of them// took a locale, while 93 files called `toLocaleDateString()` with nodiff --git a/frontend/src/utils/paletteFrecency.js b/frontend/src/utils/paletteFrecency.jsindex f1e62454..952e3d66 100644--- a/frontend/src/utils/paletteFrecency.js+++ b/frontend/src/utils/paletteFrecency.js@@ -1,4 +1,4 @@-// Per-user "frecency" for the command palette (plan 41): frequency + recency of+// Per-user "frecency" for the command palette: frequency + recency of// selections, kept in localStorage so an empty query can surface Recently used// and a matched query can boost the things you actually pick. Client-only —// server-side sync across devices is explicitly out of scope.diff --git a/frontend/src/utils/paletteScore.js b/frontend/src/utils/paletteScore.jsindex b7f07e5e..8b3e86b7 100644--- a/frontend/src/utils/paletteScore.js+++ b/frontend/src/utils/paletteScore.js@@ -1,4 +1,4 @@-// One scorer for the command palette (plan 41). A single subsequence fuzzy+// One scorer for the command palette. A single subsequence fuzzy// matcher with a word-start bonus, used across every provider so results from// pages, settings, actions, and entities rank on the same scale. cmdk's own// matcher is disabled (shouldFilter={false}) so this is the ONLY filter.diff --git a/frontend/src/utils/time.js b/frontend/src/utils/time.jsindex 40046a57..8527f710 100644--- a/frontend/src/utils/time.js+++ b/frontend/src/utils/time.js@@ -1,6 +1,6 @@// Relative-time and duration helpers.//-// Plan 79 §C: the implementations moved to `utils/intl.js`, which is the one+// The implementations moved to `utils/intl.js`, which is the one// locale-aware formatting door. These names stay because ten files import// them and the two output shapes are deliberate — but they are now thin// delegations, not a second implementation. Notably the date tail of both