ui progressing

docs/modules/ui/v2-rewire/pack-23.md

@@ -0,0 +1,85 @@
+# Pack 23 - Platform Global Ops/Integrations/Setup Advisory Delta
+
+Status: Active high-precedence authority for Platform IA and ownership
+Date: 2026-02-20
+Precedence: Overrides `pack-22.md` and lower packs for overlapping Platform navigation, ownership, and operator workflow behavior.
+
+## 1) Intent
+
+- Make `Platform` a global root and consolidate operability into one module shell.
+- Keep three explicit Platform subdomains:
+  - `Ops`,
+  - `Integrations`,
+  - `Setup`.
+- Reduce cognitive load by consolidating operations surfaces around decision impact.
+
+## 2) Canonical Platform model
+
+### 2.1 Platform as global root
+
+- `Platform` is a top-level module.
+- `Integrations` and `Setup` are no longer separate top-level roots.
+- Canonical IA under Platform:
+  - `/platform/ops/*`
+  - `/platform/integrations/*`
+  - `/platform/setup/*`
+
+### 2.2 Ops workflow priority
+
+Ops primary workflows:
+
+1. `Data Integrity`
+2. `Jobs & Queues`
+3. `Health & SLO`
+
+Ops secondary tools:
+
+- `Feeds & Airgap`
+- `Quotas & Limits`
+- `Diagnostics`
+
+### 2.3 Ownership boundaries
+
+- `Topology` owns hosts/targets/agents management.
+- `Platform Integrations` owns external systems only:
+  - Registries,
+  - SCM,
+  - CI/CD,
+  - Runtimes / Hosts (connectors only),
+  - Advisory sources,
+  - VEX sources,
+  - Secrets.
+- `Platform Setup` owns inventory and orchestration setup:
+  - Regions & Environments,
+  - Promotion Paths,
+  - Workflows & Gates,
+  - Gate Profiles,
+  - Release Templates.
+  - Feed Policy,
+  - Defaults & Guardrails.
+
+## 3) Degraded/offline UX contract
+
+Platform operator views must provide:
+
+- explicit decision impact label (`BLOCKING`, `DEGRADED`, `INFO`),
+- retry controls,
+- copyable correlation ID,
+- last-known-good/read-only context when live dependencies degrade.
+
+## 4) Route mapping directives
+
+- Keep legacy aliases for migration safety:
+  - `/integrations/*` -> `/platform/integrations/*`
+  - `/platform-ops/*` and `/operations/*` -> `/platform/ops/*`
+- Legacy hosts/targets integration links must redirect to Topology:
+  - `/platform/integrations/hosts` -> `/topology/hosts`
+  - `/platform/integrations/targets*` -> `/topology/targets`
+
+## 5) Planning and QA gates
+
+- Platform nav and submenus reflect the Ops/Integrations/Setup split.
+- Integrations screens do not present hosts/targets/agents as managed integration categories.
+- Integrations include `Runtimes / Hosts` as connector category while inventory ownership remains in Topology.
+- Setup routes render setup-owned pages, including `Feed Policy`, `Gate Profiles`, and `Defaults & Guardrails`.
+- Focused FE route/nav/platform tests pass for changed surfaces before sprint closure.