Migrate Ops interface patterns

2026-08-03 15:18:32 +02:00
parent cdcb477b55
commit 2b3264372b
8 changed files with 367 additions and 25 deletions
@@ -133,7 +133,22 @@ manifest = ModuleManifest(
            documentation_types=("admin", "user"),
            audience=("operator", "system_admin"),
            related_modules=("audit", "docs", "notifications"),
-            metadata={"kind": "reference"},
+            metadata={
+                "kind": "reference",
+                "help_contexts": [
+                    "ops.page",
+                    "ops.page.summary",
+                    "ops.page.health",
+                    "ops.page.governance",
+                    "ops.page.deployment",
+                    "ops.page.sizing",
+                    "ops.widget.health",
+                    "ops.state.read-only",
+                ],
+                "consequence_classes": {
+                    "run_probes": "run bounded module-owned health probes and refresh the sanitized operational projection",
+                },
+            },
        ),
        DocumentationTopic(
            id="ops.runtime-coordination-and-recovery",
@@ -165,6 +180,18 @@ manifest = ModuleManifest(
                    "Ops does not create or restore backups and never receives private artifact or key-custody references.",
                    "A verified receipt proves the recorded drill; it does not make an unsafe post-migration code rollback reversible.",
                ],
+                "help_contexts": [
+                    "ops.page.runtime",
+                    "ops.page.recovery",
+                    "ops.action.drain-node",
+                    "ops.state.readiness-blocked",
+                    "ops.state.stale-node",
+                ],
+                "consequence_classes": {
+                    "drain_node": "stop routing new work to the selected runtime incarnation while in-flight work completes",
+                    "cancel_node_drain": "return a still-draining runtime node to active scheduling",
+                    "inspect_recovery": "read sanitized durable recovery state without replaying or repairing the owning effect",
+                },
            },
        ),
    ),
@@ -199,6 +226,92 @@ manifest = ModuleManifest(
            ),
        ),
        view_surfaces=(
+            ViewSurface(
+                id="ops.navigation",
+                module_id="ops",
+                kind="navigation",
+                label="Operations navigation",
+                order=10,
+            ),
+            ViewSurface(
+                id="ops.page",
+                module_id="ops",
+                kind="route",
+                label="Operations workspace",
+                order=20,
+            ),
+            ViewSurface(
+                id="ops.page.summary",
+                module_id="ops",
+                kind="section",
+                label="Operations summary",
+                parent_id="ops.page",
+                order=10,
+            ),
+            ViewSurface(
+                id="ops.page.health",
+                module_id="ops",
+                kind="section",
+                label="Health checks",
+                parent_id="ops.page",
+                order=20,
+            ),
+            ViewSurface(
+                id="ops.page.runtime",
+                module_id="ops",
+                kind="section",
+                label="Runtime cluster",
+                parent_id="ops.page",
+                order=30,
+            ),
+            ViewSurface(
+                id="ops.page.recovery",
+                module_id="ops",
+                kind="section",
+                label="Recovery evidence",
+                parent_id="ops.page",
+                order=40,
+            ),
+            ViewSurface(
+                id="ops.page.governance",
+                module_id="ops",
+                kind="section",
+                label="Governance inventory",
+                parent_id="ops.page",
+                order=50,
+            ),
+            ViewSurface(
+                id="ops.page.deployment",
+                module_id="ops",
+                kind="section",
+                label="Deployment profiles",
+                parent_id="ops.page",
+                order=60,
+            ),
+            ViewSurface(
+                id="ops.page.sizing",
+                module_id="ops",
+                kind="section",
+                label="Sizing assumptions",
+                parent_id="ops.page",
+                order=70,
+            ),
+            ViewSurface(
+                id="ops.action.run-probes",
+                module_id="ops",
+                kind="action",
+                label="Run operational probes",
+                parent_id="ops.page.health",
+                order=80,
+            ),
+            ViewSurface(
+                id="ops.action.drain-node",
+                module_id="ops",
+                kind="action",
+                label="Drain runtime node",
+                parent_id="ops.page.runtime",
+                order=90,
+            ),
            ViewSurface(
                id="ops.widget.health",
                module_id="ops",