docs: integrate autonomous migration slices

2026-08-10 18:16:14 -05:00
parent 39987a5b61
commit 53d4ea6ec6
7 changed files with 80 additions and 26 deletions
@@ -1,6 +1,6 @@
 # Administrator Guide

-> **Status:** Scaffold only. No legacy page has been promoted into this book yet.
+> **Status:** Partially migrated. Current SSO and local upgrade/recovery procedures are available; held procedures are labeled non-operative.

 This book is the canonical home for installation, configuration, deployment, routine operations, security controls, incident response, and recovery. User workflows belong in [`USER-GUIDE/`](../USER-GUIDE/); implementation and contributor material belongs in [`DEVELOPER-GUIDE/`](../DEVELOPER-GUIDE/).

@@ -9,17 +9,19 @@ This book is the canonical home for installation, configuration, deployment, rou
 - [Documentation atlas](../README.md) — placement rules and source-of-truth boundaries.
 - [Documentation sitemap](../SITEMAP.md) — existing navigation is transitional and still contains legacy paths.
 - [Product requirements](../PRD.md) — normative requirements, currently marked draft.
+- [Operations index](operations/README.md) — current local procedures and explicitly held operational outlines.
+- [Security index](security/README.md) — current SSO provider configuration.

 ## Chapter map

-| Chapter                           | Scope                                                               | Status                                                  |
-| --------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------- |
-| `installation/`                   | Prerequisites, installation, and first deployment.                  | Scaffold only.                                          |
-| `configuration/`                  | Environment, provider, tier, and runtime configuration.             | Scaffold only.                                          |
-| `deployment/`                     | Topologies, rollout, migration, and upgrade procedures.             | Scaffold only.                                          |
-| `operations/`                     | Health, observability, routine operation, and maintenance.          | Scaffold only.                                          |
-| [`security/`](security/README.md) | Authentication, authorization, SSO, secrets, and security controls. | SSO provider guide is current; other pages are planned. |
-| `recovery/`                       | Incident response, backup, rollback, and recovery.                  | Scaffold only.                                          |
+| Chapter                               | Scope                                                               | Status                                                                  |
+| ------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `installation/`                       | Prerequisites, installation, and first deployment.                  | Scaffold only.                                                          |
+| `configuration/`                      | Environment, provider, tier, and runtime configuration.             | Scaffold only.                                                          |
+| `deployment/`                         | Topologies, rollout, migration, and upgrade procedures.             | Scaffold only.                                                          |
+| [`operations/`](operations/README.md) | Health, observability, routine operation, and maintenance.          | Local upgrade/recovery is current; connector lease operations are held. |
+| [`security/`](security/README.md)     | Authentication, authorization, SSO, secrets, and security controls. | SSO provider guide is current; other pages are planned.                 |
+| `recovery/`                           | Incident response, backup, rollback, and recovery.                  | Scaffold only.                                                          |

 Every promoted page must be added to this index and to [`SITEMAP.md`](../SITEMAP.md) in the same migration slice.

@@ -0,0 +1,19 @@
+# Administrator Operations
+
+> **Status:** Partially migrated. Procedures explicitly identify whether they are current or held.
+
+## Current procedures
+
+- [Upgrade safety and recovery](upgrade-safety-and-recovery.md) — installed-CLI and local-PGlite upgrade, rollback, and framework-configuration recovery.
+
+## Held procedures
+
+- [Mos connector lease operations](mos-connector-lease-operations.md) — non-operative M1 outline while the gateway policy remains deny-all and no connector is activated.
+
+A held page is architecture and readiness context, not command authority. PostgreSQL, federated, bare-metal, Compose, Gateway/Web activation, and migration-runner procedures remain outside the current local route unless a later page explicitly removes the hold with verified evidence.
+
+## Related
+
+- [[ADMIN-GUIDE/README|Administrator guide]]
+- [[ADMIN-GUIDE/security/README|Administrator security]]
+- [[DEVELOPER-GUIDE/architecture/README|Architecture index]]