Finalize UI truthfulness and bootstrap hardening

docs/modules/cli/guides/admin/admin-reference.md

@@ -4,7 +4,7 @@
 
 ## Overview
 
-The `stella admin` command group provides administrative operations for platform management. These commands require elevated authentication and are used for policy management, user administration, feed configuration, and system maintenance.
+The `stella admin` command group provides administrative operations for platform management. These commands require elevated authentication and are used for policy management, user administration, feed configuration, diagnostics, and system maintenance.
 
 ## Authentication
 
@@ -30,6 +30,7 @@ Admin commands require one of the following authentication methods:
 | `stella admin policy` | `admin.policy` | Policy management operations |
 | `stella admin users` | `admin.users` | User administration |
 | `stella admin feeds` | `admin.feeds` | Feed management |
+| `stella admin diagnostics` | `ops.health` / `ops.admin` | Platform readiness and operator diagnostics |
 | `stella admin system` | `admin.platform` | System operations |
 
 ## Command Reference
@@ -327,6 +328,42 @@ stella admin feeds history --source osv --limit 50
 
 ---
 
+### stella admin diagnostics
+
+Readiness and operator diagnostics backed by the Platform service.
+
+#### stella admin diagnostics health
+
+Show the canonical platform readiness summary, including setup-blocking required dependencies and configured optional post-boot services.
+
+**Usage:**
+```bash
+stella admin diagnostics health [--detail] [--format <format>]
+```
+
+**Options:**
+- `--detail` - Include endpoint information in the table output
+- `--format <format>` - Output format: `table` (default), `json`
+
+**Notes:**
+- Required dependencies are the same blockers used by `stella setup status` and setup finalization.
+- Optional dependencies are configured post-boot services discovered by the Platform readiness endpoint.
+- JSON output is camelCase and intended to stay machine-readable.
+
+**Examples:**
+```bash
+# Show readiness in the default table view
+stella admin diagnostics health
+
+# Include endpoint details for each dependency
+stella admin diagnostics health --detail
+
+# Emit the readiness payload for automation
+stella admin diagnostics health --format json
+```
+
+---
+
 ### stella admin system
 
 System management and health commands.
@@ -408,6 +445,7 @@ Admin commands call the following backend APIs:
 | `/api/v1/admin/feeds/status` | GET | `stella admin feeds status` |
 | `/api/v1/admin/feeds/{id}/refresh` | POST | `stella admin feeds refresh` |
 | `/api/v1/admin/feeds/{id}/history` | GET | `stella admin feeds history` |
+| `/api/v1/platform/health/readiness` | GET | `stella admin diagnostics health` |
 | `/api/v1/admin/system/status` | GET | `stella admin system status` |
 | `/api/v1/admin/system/info` | GET | `stella admin system info` |