Skip to content

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.

Remove internal plan citations from app code

Juan Denis6296887bad25
diff --git a/backend/app/__init__.py b/backend/app/__init__.py
index 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 logging
logging.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 RecipeExecutionService
RecipeExecutionService.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 BackupService
BackupService.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_service
log_limits_service.converge()
from app.services.speed_test_service import SpeedTestService
diff --git a/backend/app/agent_gateway.py b/backend/app/agent_gateway.py
index f31e55ab..cefc2de4 100644
--- a/backend/app/agent_gateway.py
+++ b/backend/app/agent_gateway.py
@@ -20,7 +20,7 @@ from app.models.server import Server
logger = 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 shared
with the long-poll /connect endpoint; this handler only translates
the outcome into socket emits/disconnects.
diff --git a/backend/app/api/agent_poll.py b/backend/app/api/agent_poll.py
index 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 a
polling-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-room
bookkeeping; 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.py
index 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 attachments
GET /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_required
diff --git a/backend/app/api/app_slots.py b/backend/app/api/app_slots.py
index 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 + reasons
PUT /<app_id>/slots — {enabled}: opt in (adopts the current
diff --git a/backend/app/api/app_volumes.py b/backend/app/api/app_volumes.py
index 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 persistent
volumes for an application. Mounted under ``/api/v1/apps`` alongside the main
diff --git a/backend/app/api/apps.py b/backend/app/api/apps.py
index 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 entries
for 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.py
index 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_service
plugin_service.finalize_setup_flagships()
diff --git a/backend/app/api/backups.py b/backend/app/api/backups.py
index 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_found
backups_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.py
index 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_required
def 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_required
def 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.py
index 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 live
Deploy Console. `?wait=true` preserves the old synchronous contract for
CLI/tests (runs inline, returns the deployment result body).
diff --git a/backend/app/api/connect.py b/backend/app/api/connect.py
index 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_required
def get_managed_profile():
- """The managed profile in force (plan 25). Read-only: the signed
+ """The managed profile in force. Read-only: the signed
ui.managed_profile command handler is the only writer, and lifting the
profile from ServerKit Cloud — never from here — is the only off switch
other than expiry or revocation."""
diff --git a/backend/app/api/container_status.py b/backend/app/api/container_status.py
index 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.py
index 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.py
index 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 to
the calling user: a board that belongs to somebody else is indistinguishable
diff --git a/backend/app/api/database_engines.py b/backend/app/api/database_engines.py
index 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.py
index 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.py
index 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 os
diff --git a/backend/app/api/deployment_jobs.py b/backend/app/api/deployment_jobs.py
index 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 the
surface 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.py
index 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.py
index 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 any
authenticated user; the mutating verbs (snapshot, cutover, revert) are
-admin-only (plan 31 #1/#2/#3).
+admin-only.
"""
from flask import Blueprint, request, jsonify
from flask_jwt_extended import jwt_required
diff --git a/backend/app/api/domains.py b/backend/app/api/domains.py
index 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 re
diff --git a/backend/app/api/env_vars.py b/backend/app/api/env_vars.py
index 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 is
diff --git a/backend/app/api/fleet_doctor.py b/backend/app/api/fleet_doctor.py
index 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.py
index 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_service
token = request.args.get('token') or request.headers.get('X-Prometheus-Token')
diff --git a/backend/app/api/git.py b/backend/app/api/git.py
index 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; an
app-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_required
def list_webhooks():
- """List webhooks the caller can see (plan 29 #11): every unlinked webhook
+ """List webhooks the caller can see: every unlinked webhook
plus 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.py
index 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, jsonify
from 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 caller
gets 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.py
index 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), 400
diff --git a/backend/app/api/pairing.py b/backend/app/api/pairing.py
index 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.py
index 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 reaching
for, which is operator information.
diff --git a/backend/app/api/previews.py b/backend/app/api/previews.py
index 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`` requires
can_edit_app (owner/admin/editor); otherwise can_access_app (adds workspace
members). 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.py
index 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.py
index 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, jsonify
diff --git a/backend/app/api/recipes.py b/backend/app/api/recipes.py
index 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 manifest
diff --git a/backend/app/api/restore_points.py b/backend/app/api/restore_points.py
index 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-level
surfaces are operational and require a developer role even when their local
diff --git a/backend/app/api/runs.py b/backend/app/api/runs.py
index 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: any
run kind's persisted lines, resumable via ?after_id, so a client that missed
diff --git a/backend/app/api/search.py b/backend/app/api/search.py
index 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 the
core entity types (services, servers, domains, databases, WordPress sites, cron
diff --git a/backend/app/api/security.py b/backend/app/api/security.py
index 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.py
index 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.py
index 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_required
def 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 host
that 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 data
diff --git a/backend/app/api/snapshots.py b/backend/app/api/snapshots.py
index 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`` requires
can_edit_app (owner/admin/editor); otherwise can_access_app. A caller without
the 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.py
index 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: a
survey 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_required
def 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. Existing
managed 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_required
def 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 many
commands the Observe guard has blocked — the "blocked N commands" counter.
diff --git a/backend/app/api/system.py b/backend/app/api/system.py
index 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.py
index 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 Endpoints
diff --git a/backend/app/api/themes.py b/backend/app/api/themes.py
index 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. This
blueprint lists themes (bundled seeds + installed), imports a pasted/uploaded
diff --git a/backend/app/api/waf.py b/backend/app/api/waf.py
index 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 missing
app (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.py
index 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 WorkspaceService
from app.services.audit_service import AuditService
from 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.py
index 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.yaml
index 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 ships
diff --git a/backend/app/exceptions.py b/backend/app/exceptions.py
index 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.py
index 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_service
try:
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_service
level = disk_alert_service.check()
return {'level': level} if level else None
def 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 retention
rather 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, not
removed: a switch back to one is a start + health gate away."""
from app.services.slot_deploy_service import SlotDeployService
return SlotDeployService.sweep_standby() or None
def 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 CrashLoopService
return 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_NAME
ScheduledJobService.ensure(
diff --git a/backend/app/jobs/consumer.py b/backend/app/jobs/consumer.py
index 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.py
index 62e7c668..b8b98df1 100644
--- a/backend/app/jobs/models.py
+++ b/backend/app/jobs/models.py
@@ -21,7 +21,7 @@ from app import db
class 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.py
index 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.py
index 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 -> None
The 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.py
index 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, or
the 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.py
index 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``; the
sampler writes both on ingest, so downsampling is just a coarser bucket, not a
diff --git a/backend/app/models/app_slot.py b/backend/app/models/app_slot.py
index 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``, and
flips between them. An app with slot deploys enabled gets the same: rows
diff --git a/backend/app/models/app_volume.py b/backend/app/models/app_volume.py
index 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 nukes
diff --git a/backend/app/models/application.py b/backend/app/models/application.py
index 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". That
distinction is not cosmetic here: this model drives nginx vhosts, container
lifecycles, 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 linking
diff --git a/backend/app/models/backup_policy.py b/backend/app/models/backup_policy.py
index 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):
# Remote
remote_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.py
index 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.py
index 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 of
widget instances laid out on a 12-column grid. Boards belong to a user, not to
diff --git a/backend/app/models/db_snapshot.py b/backend/app/models/db_snapshot.py
index 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-sync
records. 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 owns
generic machinery. The tables (``database_snapshots``, ``sync_jobs``) are
unchanged — this was a pure module move. Their foreign keys still reference
``wordpress_sites`` (the only environment kind that uses them today); that is a
diff --git a/backend/app/models/deployment.py b/backend/app/models/deployment.py
index 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 live
once" 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.py
index 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.py
index 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 JsonColumnMixin
class 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.py
index 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.py
index 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 hard
diff --git a/backend/app/models/env_variable.py b/backend/app/models/env_variable.py
index 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 bulk
diff --git a/backend/app/models/fleet_doctor_result.py b/backend/app/models/fleet_doctor_result.py
index 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 JsonColumnMixin
class 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; the
fleet sweep instead records each remote server's per-check outcome as a ROW
diff --git a/backend/app/models/json_column_mixin.py b/backend/app/models/json_column_mixin.py
index 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 or
partially-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 earlier
ruling that unprotected ``json.loads`` sites were out of scope: the sites that
used to let corrupt data raise were converted too, so a corrupt row now
degrades to the accessor's default instead of failing every request that
diff --git a/backend/app/models/linked_panel.py b/backend/app/models/linked_panel.py
index 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.py
index 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 through
an 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 the
Recycle Bin — the actual database server-side is untouched and any managed
backup policy keeps running, so restore brings everything back intact. The
explicit ``?drop=true`` path stays immediately destructive. Read paths use
diff --git a/backend/app/models/mixins.py b/backend/app/models/mixins.py
index 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 undecryptable
Server.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-rolled
accessors 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 format
decision is made once — a second format (e.g. 32-char hex) would break
FK joins against String(36) columns. The lone pre-existing deviant is
ai.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 (the
ternary previously pasted ~266 times), ``*_encrypted`` columns and any
name in ``__serialize_exclude__`` are dropped, and ``serialize_extra()`` merges
computed fields on top. A model whose dict genuinely differs from its
columns (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 the
FULL dict; response shaping stays _query's job.
diff --git a/backend/app/models/notification_preferences.py b/backend/app/models/notification_preferences.py
index 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: boolean
categories = 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 migrations
diff --git a/backend/app/models/plugin.py b/backend/app/models/plugin.py
index 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.py
index 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 deploy
kind; every OTHER run kind (unified jobs, sandbox runs, site imports,
diff --git a/backend/app/models/server.py b/backend/app/models/server.py
index 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):
@property
def 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 key
api_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.py
index 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 JsonColumnMixin
class 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; the
panel normalizes it and stores it here as a versioned, immutable snapshot.
diff --git a/backend/app/models/status.py b/backend/app/models/status.py
index 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 run
models (``success`` in cron_run/backup_run, ``completed`` in db_snapshot and
diff --git a/backend/app/models/system_settings.py b/backend/app/models/system_settings.py
index 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.value
diff --git a/backend/app/models/theme.py b/backend/app/models/theme.py
index 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 plus
gallery metadata. Installed themes (imported, studio-authored, or pulled from
diff --git a/backend/app/models/user.py b/backend/app/models/user.py
index 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)
# Relationships
diff --git a/backend/app/models/wordpress_site.py b/backend/app/models/wordpress_site.py
index 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 JsonColumnMixin
from 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.py
index 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 (see
diff --git a/backend/app/notifications/channels/chat.py b/backend/app/notifications/channels/chat.py
index 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.py
index 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 BounceService
if BounceService.is_muted(to_addr):
return DeliveryResult.skipped('address muted (bouncing)')
diff --git a/backend/app/notifications/digest.py b/backend/app/notifications/digest.py
index 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 routes
digestable deliveries (and quiet-hours catch-ups) onto the
diff --git a/backend/app/notifications/links.py b/backend/app/notifications/links.py
index 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 a
route 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.py
index 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 successfully
STATUS_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.py
index 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) are
diff --git a/backend/app/plugins/serverkit-status/__init__.py b/backend/app/plugins/serverkit-status/__init__.py
index 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/badge
routes + authenticated management API) and its service ship here so a fresh panel
that 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.py
index 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. It
diff --git a/backend/app/services/agent_registry.py b/backend/app/services/agent_registry.py
index 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_id
self._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:
return
try:
# 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_attr
TunnelBrokerService = get_installed_extension_attr(
diff --git a/backend/app/services/app_attachment_service.py b/backend/app/services/app_attachment_service.py
index 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 the
service'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.py
index 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 to
v11" 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 actually
ran.
-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 of
leak, so they are pruned on every successful deploy: images of the newest
``keep`` deployments stay, plus anything a slot or the live deployment still
references. ``docker rmi`` without ``-f`` refuses an image a container is
diff --git a/backend/app/services/app_port_service.py b/backend/app/services/app_port_service.py
index 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 list
on ``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.py
index 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 False
if 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 container
if not app.buildpack_type:
return False
return 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 slot
project, not the project the app's own compose file would name."""
from app.services.slot_deploy_service import SlotDeployService
return 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_name
return live_container_name(app)
diff --git a/backend/app/services/backup_alert_service.py b/backend/app/services/backup_alert_service.py
index 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" would
re-alert every sweep. These alerts are STATE-TRANSITION only: a failure fires
@@ -47,7 +47,7 @@ class BackupAlertService:
@staticmethod
def _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.py
index 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 scratch
location (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 a
scratch dir, AND import ``database.sql`` into a throwaway scratch DB. A
drill that verified neither artifact fails instead of earning 'drilled'
- vacuously (plan 30)."""
+ vacuously."""
import tarfile
from app.services.backup_service import BackupService
from app.services.database_service import DatabaseService
diff --git a/backend/app/services/backup_kind_registry.py b/backend/app/services/backup_kind_registry.py
index 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 = F
Namespace it after your plugin (``minecraft.world``); the bare words core
uses 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/restore
diff --git a/backend/app/services/backup_offsite_service.py b/backend/app/services/backup_offsite_service.py
index 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. Today
every 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 its
own — so a full backup is never left unproven because a different
destination happened to win the single-sample lottery."""
meta = run.get_metadata() or {}
@@ -85,8 +85,8 @@ class BackupOffsiteService:
@classmethod
def _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 while
storage 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.py
index 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, plus
db_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 older
diff --git a/backend/app/services/backup_verify_service.py b/backend/app/services/backup_verify_service.py
index 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 and
then 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.py
index 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 reruns
diff --git a/backend/app/services/bottleneck_hints_service.py b/backend/app/services/bottleneck_hints_service.py
index 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), its
container'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 box
slow + 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 deploys
micro-cache on, low hit ratio → the pages vary too much, or the TTL is short
Not 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.py
index 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 / a
generic shape) into ``EmailBounceState`` rows. Provider payloads are normalized
diff --git a/backend/app/services/build_service.py b/backend/app/services/build_service.py
index 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 the
image; 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.py
index 7ca0ce27..74e72ad7 100644
--- a/backend/app/services/buildpack_service.py
+++ b/backend/app/services/buildpack_service.py
@@ -413,7 +413,7 @@ class BuildpackService:
@classmethod
def _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 publish
strings (typed L4 ports) appended to the app's own HTTP port;
``volumes`` are service mount specs and ``named_volumes`` declare the
top-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.py
index 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.py
index 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.py
index 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 receives
diff --git a/backend/app/services/cloudflare_ops_bridge.py b/backend/app/services/cloudflare_ops_bridge.py
index 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), then
the builtin registration (pre-cutover trees), then the historical core
location. 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.py
index 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_service
pooler = pooler_service.sidecar(app, services)
diff --git a/backend/app/services/connect_client.py b/backend/app/services/connect_client.py
index 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_profile
connect_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_profile
connect_managed_profile.clear('revoked', app=self.app)
diff --git a/backend/app/services/connect_managed_profile.py b/backend/app/services/connect_managed_profile.py
index 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 — and
the 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*. Every
route 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.py
index 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 talks
to 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.py
index 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.py
index 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.py
index 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 the
panel: 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.py
index 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 the
member-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 format
if not cls._validate_schedule(schedule):
return {'success': False, 'error': 'Invalid cron schedule format'}
@@ -942,7 +942,7 @@ class CronService:
@classmethod
def 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.py
index 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 a
dashboard tab; a widget instance is ``{i, type, x, y, w, h, cfg}`` placed on a
diff --git a/backend/app/services/database_service.py b/backend/app/services/database_service.py
index 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 a
real rule — the password goes in the environment, never on the argv,
where ``ps`` and the shell history would see it — and a rule that lives
in 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 that
show the output to a human do not. It is a flag rather than a second
method 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.py
index 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:
@classmethod
def 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 and
diff --git a/backend/app/services/db_exec.py b/backend/app/services/db_exec.py
index 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 — was
written three times: `db_config_tuner_service`, `db_process_service`, and
diff --git a/backend/app/services/db_insights_service.py b/backend/app/services/db_insights_service.py
index 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 the
same target shape as :mod:`db_process_service`:
diff --git a/backend/app/services/demo_deploy_service.py b/backend/app/services/demo_deploy_service.py
index 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 log
stream, ErrorCard + hints, SuccessBanner, retry) on any dev machine with no
Docker, shell, or network access. The "runner" is a script that drives the
REAL ``RunLogStream``, so DB rows, socket batches, poll fallback, failure
diff --git a/backend/app/services/deploy_lock.py b/backend/app/services/deploy_lock.py
index 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 at
once: both stopped the container, both started one, and whichever lost the
diff --git a/backend/app/services/deploy_preflight_service.py b/backend/app/services/deploy_preflight_service.py
index 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 new
configuration. An invalid compose file, an image that no longer pulls, or a
port 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 ** 2
diff --git a/backend/app/services/deploy_settings.py b/backend/app/services/deploy_settings.py
index 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 a
missing key means the default below. ``effective(app)`` is what every reader
diff --git a/backend/app/services/deploy_stages.py b/backend/app/services/deploy_stages.py
index 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 runner
advances it with ``set_step``. A deploy passes through several services
diff --git a/backend/app/services/deployment_runner.py b/backend/app/services/deployment_runner.py
index 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_step
result = DockerService.compose_up_streaming(
project_dir,
diff --git a/backend/app/services/deployment_service.py b/backend/app/services/deployment_service.py
index 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 deploy
lock 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, DeployLockTimeout
try:
@@ -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_settings
app_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 EventService
EventService.emit('app.deployed', {
@@ -352,7 +352,7 @@ class DeploymentService:
from app.services.slot_deploy_service import SlotDeployService, SlotDeployError
if 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 EnvService
env = 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 SlotDeployService
if 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.py
index 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 reached
diff --git a/backend/app/services/dns_cutover_service.py b/backend/app/services/dns_cutover_service.py
index 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 — the
panel 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 revert
can 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 ──────────────────────────────────────────────────
@classmethod
def 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. Then
re-apply every captured record with ``allow_foreign=True`` (the record
now 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 DnsRecordSpec
diff --git a/backend/app/services/docker_service.py b/backend/app/services/docker_service.py
index 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 SlotDeployService
return 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:
@staticmethod
def 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 app
projects 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 output
line-by-line so the Deploy Console shows the real pull/build/start
transcript live (the biggest reason template-install errors used to be
unreadable). 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 live
containers are stopped, so a build failure can no longer take a site
down: 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 the
fields 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.py
index 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.py
index 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 WafService
WafService.reapply_if_enforcing(app_id)
diff --git a/backend/app/services/env_reference_service.py b/backend/app/services/env_reference_service.py
index 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's
connection 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) -------------------------------
@classmethod
def _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 ServiceConnectionService
if ServiceConnectionService.is_connectable(sibling):
diff --git a/backend/app/services/environment_domain_service.py b/backend/app/services/environment_domain_service.py
index 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_file
class 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:
@classmethod
def _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; the
private re-implementation it replaced hardcoded ``sudo`` and called
diff --git a/backend/app/services/environment_health_service.py b/backend/app/services/environment_health_service.py
index 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 EventService
diff --git a/backend/app/services/environment_pipeline_service.py b/backend/app/services/environment_pipeline_service.py
index 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.py
index 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.py
index 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.py
index 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 git
extension 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 so
only Gitea operators get the extension back automatically; deploys from
external 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 moves
that backend into the extension and deregisters it from core. On an upgraded
panel that already installed such an extension frontend-only, the installed
row 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 = True
except Exception as e:
diff --git a/backend/app/services/fail2ban_jail_service.py b/backend/app/services/fail2ban_jail_service.py
index 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}
@staticmethod
def _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 the
diff --git a/backend/app/services/firewall_service.py b/backend/app/services/firewall_service.py
index 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 False
error = None
diff --git a/backend/app/services/fleet_doctor_service.py b/backend/app/services/fleet_doctor_service.py
index 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* box
healthy?" and stores a single ``doctor_last_report`` blob. This service answers
diff --git a/backend/app/services/fleet_monitor_service.py b/backend/app/services/fleet_monitor_service.py
index 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 page
diff --git a/backend/app/services/fleet_repair_service.py b/backend/app/services/fleet_repair_service.py
index 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 that
maps a repair *kind* → the agent command it dispatches + the capability the
diff --git a/backend/app/services/fleet_sweep.py b/backend/app/services/fleet_sweep.py
index 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 a
bounded worker pool, a per-agent timeout, and a hard wall-clock budget so a
diff --git a/backend/app/services/garage_admin.py b/backend/app/services/garage_admin.py
index 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's
RPC socket and prints the JSON result, so the panel drives Garage with
diff --git a/backend/app/services/git_deploy_service.py b/backend/app/services/git_deploy_service.py
index 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 compose
and builds the images to completion while the old containers are still
serving; only then is anything stopped.
"""
@@ -411,7 +411,7 @@ class GitDeployService:
pass
if 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.py
index 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 ManifestSyncService
commit = (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 the
diff --git a/backend/app/services/grafana_provisioner.py b/backend/app/services/grafana_provisioner.py
index 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 install
creates the data source through Grafana's HTTP API, at the loopback port its
diff --git a/backend/app/services/health_gate.py b/backend/app/services/health_gate.py
index 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 the
deploy carried on as a success, and it counted a 4xx on the health path as
diff --git a/backend/app/services/history_retention_service.py b/backend/app/services/history_retention_service.py
index 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 handler
diff --git a/backend/app/services/install_profile_service.py b/backend/app/services/install_profile_service.py
index 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 box
can 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.py
index 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.py
index 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:
@classmethod
def 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 Recycle
Bin. The actual database on the server is untouched and any managed
diff --git a/backend/app/services/manifest_apply_service.py b/backend/app/services/manifest_apply_service.py
index 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 action
plan 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 registry
if 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 flag
bootstraps = 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:
continue
need = ' 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.py
index 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` already
parses: the health-check path, the manifest env, and (for v1 manifests) the
diff --git a/backend/app/services/manifest_preview_service.py b/backend/app/services/manifest_preview_service.py
index 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 and
a TTL: it clones the manifest-resolved config (env + the existing
diff --git a/backend/app/services/manifest_scaffold_service.py b/backend/app/services/manifest_scaffold_service.py
index 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 BuildService
diff --git a/backend/app/services/manifest_spec_service.py b/backend/app/services/manifest_spec_service.py
index 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:
@classmethod
def _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:
@classmethod
def _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 None
command = raw.get('command')
@@ -723,7 +723,7 @@ class ManifestSpecService:
@classmethod
def _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 None
hr = {
@@ -770,7 +770,7 @@ class ManifestSpecService:
@classmethod
def _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 a
mapping of name -> container spec, rendered as ONE compose project.
Mutually exclusive with the buildpack keys; dependsOn must reference a
diff --git a/backend/app/services/manifest_sync_service.py b/backend/app/services/manifest_sync_service.py
index 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 manifest
hash is unchanged it is a no-op (today's behavior). If it changed, services with
diff --git a/backend/app/services/member_action_service.py b/backend/app/services/member_action_service.py
index 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 trigger
for 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`, which
adjusts an app's backup schedule through the existing BackupPolicyService (no new
side-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 the
admin-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.py
index 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 in
the environment, which almost no install sets, so an installed Prometheus had
diff --git a/backend/app/services/monitor_service.py b/backend/app/services/monitor_service.py
index 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 bind
fails 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.py
index 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 EventService
diff --git a/backend/app/services/nginx_advanced_service.py b/backend/app/services/nginx_advanced_service.py
index 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:
@staticmethod
def 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:
@staticmethod
def 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, so
a broken vhost written by this same service reloaded straight into
diff --git a/backend/app/services/nginx_service.py b/backend/app/services/nginx_service.py
index 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 keys
if ($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/ {{
@classmethod
def 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`` is
removed 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 writes
each entry's key as a ``KEY: <scheme>://<host><uri>`` header line in
the cache file, so a fixed-string grep for ``KEY: http[s]://<host>/``
finds exactly this site's files; the trailing ``/`` keeps
diff --git a/backend/app/services/plugin_service.py b/backend/app/services/plugin_service.py
index 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 digest
before 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 bad
signature is a hard failure; an unpinned key installs but is
recorded 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=False
plugin.entry_point = entry_point
plugin.url_prefix = url_prefix
plugin.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 into
its 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-optional
flagship (WordPress) the user didn't install during the wizard gets the
uninstall 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't
installed. Resolves ``app.plugins.<slug>.<module>`` (the dashed package the
plugin 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 its
seeded 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 against
the panel's pinned publisher keys — a bad signature is a hard failure
even when the sha256 matches."""
from app.services import registry_service
diff --git a/backend/app/services/pooler_service.py b/backend/app/services/pooler_service.py
index 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's
managed compose override: same project, container ``<app>-pooler``, on the
diff --git a/backend/app/services/registry_service.py b/backend/app/services/registry_service.py
index 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.py
index 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 runs
exactly 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.py
index 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 cleanly
with a friendly "agent too old" 503 rather than dispatching a command the
agent will reject as unknown.
diff --git a/backend/app/services/remote_docker_service.py b/backend/app/services/remote_docker_service.py
index 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 flat
def 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 None
diff --git a/backend/app/services/request_metrics_service.py b/backend/app/services/request_metrics_service.py
index 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 into
Both 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``) contribute
latency 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.py
index 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 the
app into one capability tier (see rbac.app_access_tier) and admits
anyone 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_RANK
tier = 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.py
index f0ba94f3..64374440 100644
--- a/backend/app/services/resource_tier_service.py
+++ b/backend/app/services/resource_tier_service.py
@@ -30,8 +30,8 @@ import psutil
logger = 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_service
return host_inventory_service.data_path()
diff --git a/backend/app/services/restore_point_adapter_nginx.py b/backend/app/services/restore_point_adapter_nginx.py
index 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 file
without restoring the slot would point nginx at a standby that may be
diff --git a/backend/app/services/run_log_service.py b/backend/app/services/run_log_service.py
index 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-st
timings, sanitizes ANSI/`\\r` noise, caps the persisted row count, and matches a
plain-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 RunLike
protocol: an ``id``, a ``__run_kind__`` class attribute, a ``to_dict()``
for status emits, and — optionally — ``get_result``/``set_result`` (for
close-time enrichment) and ``current_step``/``current_step_name`` (for
diff --git a/backend/app/services/search_service.py b/backend/app/services/search_service.py
index 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 a
flat list of lightweight, deep-linkable rows. Each entity type reuses its
diff --git a/backend/app/services/security_policy_service.py b/backend/app/services/security_policy_service.py
index 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 session
The 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 and
lives 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.py
index 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 the
scan/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 probing
lives 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.py
index 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_name
pooled = _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.py
index 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 to
get a fully-working panel. Each item is a doctor-style check
diff --git a/backend/app/services/setup_reconcile_service.py b/backend/app/services/setup_reconcile_service.py
index 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 a
base domain, the sites they already created are still pointing at nothing. This
diff --git a/backend/app/services/signing_service.py b/backend/app/services/signing_service.py
index 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.py
index 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:
@classmethod
def 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, so
drift detection renders the same file."""
from app import db
app.immutable_assets = bool(enabled)
diff --git a/backend/app/services/site_import_service.py b/backend/app/services/site_import_service.py
index 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 the
source + pull result. Credentials never persist: the DB password is
scrubbed 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 GenericSshImporter
imp.status = 'analyzing'
diff --git a/backend/app/services/site_importers/ssh.py b/backend/app/services/site_importers/ssh.py
index 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 import
run'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 panel
host* (``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 through
only when present (they drive an optional remote dump). Raises
:class:`ValueError` when a required field is missing.
"""
@@ -211,7 +211,7 @@ class GenericSshImporter(BaseSiteImporter):
@staticmethod
def _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.py
index 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``, rendered
from 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.py
index 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 the
live one serves, flips a symlink, health-checks, and flips back if the check
diff --git a/backend/app/services/slot_retention_service.py b/backend/app/services/slot_retention_service.py
index 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 was
diff --git a/backend/app/services/sso_service.py b/backend/app/services/sso_service.py
index 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.py
index 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 page
diff --git a/backend/app/services/storage_profile_service.py b/backend/app/services/storage_profile_service.py
index 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 of
telemetry: on the small box ServerKit's own history competes with the apps
diff --git a/backend/app/services/support_bundle_service.py b/backend/app/services/support_bundle_service.py
index 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, last
drill age/status, cadence, offsite evidence level. Counts and states only —
no paths, no secrets, matching the bundle's scrub discipline."""
from datetime import datetime
diff --git a/backend/app/services/survey_service.py b/backend/app/services/survey_service.py
index 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 declarative
probe catalog against a paired Linux box and returns a structured payload; the
diff --git a/backend/app/services/system_service.py b/backend/app/services/system_service.py
index 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 — when
net_io_counters/net_if_* fail or return nothing, the corresponding
section is None/empty rather than raising (which would kill the whole
live metrics broadcast) or fabricating zeros.
diff --git a/backend/app/services/template_service.py b/backend/app/services/template_service.py
index 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 AppSlot
used_ports.update(row.host_port for row in
@@ -1216,7 +1216,7 @@ class TemplateService:
disk" view, which ``build_repo_index`` needs to describe the bundle
faithfully for publishing. Provider-owned templates are hidden from
the *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 an
absent extension means hidden cards and refused installs even though
the 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 until
the 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 new
version does not render, does not validate or cannot pull now fails
with the old stack still serving.
"""
diff --git a/backend/app/services/theme_registry_service.py b/backend/app/services/theme_registry_service.py
index 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: a
theme 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.py
index 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-auth
diff --git a/backend/app/services/theme_tokens.py b/backend/app/services/theme_tokens.py
index 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 CSS
custom-property names to values. This module is the backend source of truth for
the 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.py
index 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 ONE
Application and ONE compose file: the project's implicit default network is the
diff --git a/backend/app/services/uptime_service.py b/backend/app/services/uptime_service.py
index 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 file
that had stopped being updated. Now the write is atomic and the failure
diff --git a/backend/app/services/volume_service.py b/backend/app/services/volume_service.py
index 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 None
vol = AppVolume.query.filter_by(
diff --git a/backend/app/services/waf_service.py b/backend/app/services/waf_service.py
index 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: E402
NGINX_CONF_DIR = NginxService.NGINX_CONF_DIR
@@ -284,7 +284,7 @@ class WafService:
@classmethod
def _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_file
return write_privileged_file(path, content)
@@ -409,8 +409,8 @@ class WafService:
``write_app_vhost`` renders from the template, which has no WAF
include; 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 WafPolicy
policy = WafPolicy.query.filter_by(application_id=application_id).first()
diff --git a/backend/app/services/webhook_service.py b/backend/app/services/webhook_service.py
index 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 ManifestSyncService
ManifestSyncService.resync_for_app(
diff --git a/backend/app/services/wordpress_bridge.py b/backend/app/services/wordpress_bridge.py
index 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, registry
install). Its backend loads as the *dashed* package
``app.plugins.serverkit-wordpress``. Because the slug contains a dash it can
never be reached with a normal ``import`` statement
diff --git a/backend/app/services/worker_process_service.py b/backend/app/services/worker_process_service.py
index 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 the
image 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 this
from their managed override; single-container apps get it here."""
try:
from app.services.docker_service import DockerService
diff --git a/backend/app/sockets.py b/backend/app/sockets.py
index 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.py
index 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-out
deploy_<job_id> Deploy Console (legacy run envelope)
- run_<kind>_<run_id> generalized run envelope (plan 77 E1)
+ run_<kind>_<run_id> generalized run envelope
logs_<app_id> container log streaming for an app
server_<id>_<channel> generic agent-stream rebroadcast
server_<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.py
index 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: a
bool flag (or Event), a daemon Thread, a try/except around the tick (some
diff --git a/backend/app/utils/config_store.py b/backend/app/utils/config_store.py
index 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 the
same ``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 extra
behaviour around the write (cache invalidation, secret merging — those keep
their 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 module
deliberately kept the copies' plain ``open(..., 'w')`` so that no behaviour
change rode along with it, and noted that atomic writes, if ever wanted, would
land 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.py
index 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')` in
diff --git a/backend/app/utils/formatting.py b/backend/app/utils/formatting.py
index 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 and
host_inventory_service both need it, and this module imports nothing — the
duplicate 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.py
index 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 loads
diff --git a/backend/app/utils/remote_index.py b/backend/app/utils/remote_index.py
index 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 pipeline
was re-implemented per catalog (extension registry, theme registry, …) and
diff --git a/backend/app/utils/sdk.py b/backend/app/utils/sdk.py
index 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.py
index 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.py
index 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 its
duplicates 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 second
implementation, and changing its numbering would have renamed
handles users already had.
diff --git a/backend/app/utils/system.py b/backend/app/utils/system.py
index 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`` calls
sit 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 — converted
into 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 **two
competing forms**: ``run_privileged(['tee', path], input=content)`` and a
raw ``subprocess.run(['sudo', 'tee', path], ...)``. The second form is the
drift 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 one
of 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-rolled
copies 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 divergent
failure shapes ('error' vs 'message' carrying stderr); keep the key
and 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.py
index 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)] == rendered
diff --git a/backend/tests/test_no_plan_references.py b/backend/tests/test_no_plan_references.py
new file mode 100644
index 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__.py
index 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 here
so a fresh panel that never provisions cloud servers loads none of it. Mounted
under ``/api/v1/cloud`` via the manifest's ``url_prefix``. The CloudProvider /
CloudServer models stay in core (G2); this package imports them. Upgrades
diff --git a/builtin-extensions/serverkit-ftp/backend/__init__.py b/builtin-extensions/serverkit-ftp/backend/__init__.py
index 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 fresh
panel that never touches FTP loads none of it. Mounted under ``/api/v1/ftp`` via
the 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__.py
index 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/netutil
services ship here so a fresh panel that never exposes a NAT'd service loads none
of it. Mounted under ``/api/v1/tunnels`` via the manifest's ``url_prefix``. The
Tunnel / 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__.py
index 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/badge
routes + authenticated management API) and its service ship here so a fresh panel
that 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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 is
diff --git a/frontend/src/components/Sidebar.jsx b/frontend/src/components/Sidebar.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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 served
diff --git a/frontend/src/components/apps/SlotDeploysPanel.jsx b/frontend/src/components/apps/SlotDeploysPanel.jsx
index 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.jsx
index 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, show
const [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.jsx
index 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.js
index 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.jsx
index 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.js
index 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 and
diff --git a/frontend/src/components/dashboard/widgets/registry.js b/frontend/src/components/dashboard/widgets/registry.js
index 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.jsx
index 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 here
diff --git a/frontend/src/components/dashboard/widgets/useWidgetData.js b/frontend/src/components/dashboard/widgets/useWidgetData.js
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.js
index 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 single
diff --git a/frontend/src/components/git/BitbucketRepoPicker.jsx b/frontend/src/components/git/BitbucketRepoPicker.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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, and
diff --git a/frontend/src/components/git/repoProviders.jsx b/frontend/src/components/git/repoProviders.jsx
index 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.js
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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 a
diff --git a/frontend/src/components/serverdetail/serverDetailData.js b/frontend/src/components/serverdetail/serverDetailData.js
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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, stale
serving, 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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 persists
diff --git a/frontend/src/components/settings/MemberActionsCard.jsx b/frontend/src/components/settings/MemberActionsCard.jsx
index 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 the
diff --git a/frontend/src/components/settings/SidebarSettings.jsx b/frontend/src/components/settings/SidebarSettings.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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 to
install now. Only levels that resolve at least one
installable extension differ from "minimal"; each card
names exactly what it would install. */}
diff --git a/frontend/src/components/sidebarItems.js b/frontend/src/components/sidebarItems.js
index 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 the
diff --git a/frontend/src/constants/events.js b/frontend/src/constants/events.js
index 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 kind
RUN_LOG: 'run_log',
RUN_STATUS: 'run_status',
diff --git a/frontend/src/contexts/AuthContext.jsx b/frontend/src/contexts/AuthContext.jsx
index 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.jsx
index 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 is
diff --git a/frontend/src/contexts/ManagedProfileContext.jsx b/frontend/src/contexts/ManagedProfileContext.jsx
index 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-page
diff --git a/frontend/src/contexts/managedProfileContextValue.js b/frontend/src/contexts/managedProfileContextValue.js
index 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.js
index 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 "no
diff --git a/frontend/src/data/bundledThemes.js b/frontend/src/data/bundledThemes.js
index 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 one
diff --git a/frontend/src/data/commandActions.js b/frontend/src/data/commandActions.js
index 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.js
index 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 SAME
diff --git a/frontend/src/data/settingsIndex.js b/frontend/src/data/settingsIndex.js
index 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.js
index 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.js
index 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 layout
diff --git a/frontend/src/hooks/useFormat.js b/frontend/src/hooks/useFormat.js
index 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.js
index 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.js
index 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 load
diff --git a/frontend/src/hooks/useServerStream.js b/frontend/src/hooks/useServerStream.js
index 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.js
index 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 is
diff --git a/frontend/src/hooks/useTableViews.js b/frontend/src/hooks/useTableViews.js
index 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 broken
diff --git a/frontend/src/i18n/index.js b/frontend/src/i18n/index.js
index 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.js
index 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 pair
diff --git a/frontend/src/i18n/resolveLocale.js b/frontend/src/i18n/resolveLocale.js
index 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.jsx
index 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 and
diff --git a/frontend/src/main.jsx b/frontend/src/main.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.jsx
index 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.js
index 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.jsx
index 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.mjs
index 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.mjs
index 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.js
index 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.js
index 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) and
diff --git a/frontend/src/plugins/runtime/sdkGate.js b/frontend/src/plugins/runtime/sdkGate.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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 modules
diff --git a/frontend/src/plugins/serverkit-gui/components/ServerGui.jsx b/frontend/src/plugins/serverkit-gui/components/ServerGui.jsx
index 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.mjs
index 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 the
diff --git a/frontend/src/services/api/apps.js b/frontend/src/services/api/apps.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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 is
diff --git a/frontend/src/services/api/imports.js b/frontend/src/services/api/imports.js
index 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.js
index 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 route
diff --git a/frontend/src/services/api/search.js b/frontend/src/services/api/search.js
index 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.js
index 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 endpoints
export async function getFirewallStatus() {
diff --git a/frontend/src/services/api/survey.js b/frontend/src/services/api/survey.js
index 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.js
index 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 tile
diff --git a/frontend/src/services/api/themes.js b/frontend/src/services/api/themes.js
index 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.js
index 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.scss
index 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 a
diff --git a/frontend/src/styles/_variables.scss b/frontend/src/styles/_variables.scss
index 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.scss
index 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 bar
diff --git a/frontend/src/styles/components/_command-palette.scss b/frontend/src/styles/components/_command-palette.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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 Deploy
diff --git a/frontend/src/styles/pages/_doctor.scss b/frontend/src/styles/pages/_doctor.scss
index 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.scss
index 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.scss
index 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-jobs
diff --git a/frontend/src/styles/pages/_marketplace.scss b/frontend/src/styles/pages/_marketplace.scss
index 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.scss
index 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 across
diff --git a/frontend/src/styles/pages/_notification-center.scss b/frontend/src/styles/pages/_notification-center.scss
index 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.scss
index 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.scss
index 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.scss
index 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.scss
index 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.js
index 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.js
index 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 other
diff --git a/frontend/src/utils/formatNumber.js b/frontend/src/utils/formatNumber.js
index 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.js
index 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 no
diff --git a/frontend/src/utils/paletteFrecency.js b/frontend/src/utils/paletteFrecency.js
index 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.js
index 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.js
index 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