From 9e776f23edef8a20b9cd22e47811d7acc2ffdec5 Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Thu, 19 Nov 2026 22:33:42 +1100 Subject: [PATCH] fix(ui/astryx-reference): remove internal stage vocabulary from reference pages Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- ui/astryx-reference/AreaPage.tsx | 5 - .../pages/ConversationPage.tsx | 77 ------ ui/astryx-reference/pages/RunsPage.tsx | 224 +----------------- 3 files changed, 3 insertions(+), 303 deletions(-) diff --git a/ui/astryx-reference/AreaPage.tsx b/ui/astryx-reference/AreaPage.tsx index 6837a148f..e7754ee69 100644 --- a/ui/astryx-reference/AreaPage.tsx +++ b/ui/astryx-reference/AreaPage.tsx @@ -1,4 +1,3 @@ -import { Badge } from "@astryxdesign/core/Badge"; import { Button } from "@astryxdesign/core/Button"; import { Heading } from "@astryxdesign/core/Heading"; import { Layout, LayoutContent, LayoutHeader } from "@astryxdesign/core/Layout"; @@ -20,7 +19,6 @@ const copy = { eyebrow: "Monitoring · 09:38 UTC", body: "Checkout timeouts rose after the latest release. Archie authenticated the event, bound it to the production checkout target, and started an investigation run.", action: "Open investigation", - seam: "Hears → Understands → Decides", }, Governance: { heading: "Governance", @@ -29,7 +27,6 @@ const copy = { eyebrow: "Production · Checkout · Rollback", body: "The current autonomy level permits read-only investigation. The rollback is reversible, but it changes production. Hard rules and the Timing guard therefore require an operator decision.", action: "Review decision", - seam: "Governs · Assesses · Manages risk · Invokes policy", }, Reports: { heading: "What Archie delivered", @@ -38,7 +35,6 @@ const copy = { eyebrow: "Operations · Waiting on approval", body: "The investigation and evidence are in Operations. No production change has been made. The underlying release defect remains to be confirmed.", action: "Open decision trail", - seam: "Does → Delivers", }, } as const; @@ -63,7 +59,6 @@ export function AreaPage({ area, onOpenRun }: AreaPageProps) {
- {content.eyebrow} diff --git a/ui/astryx-reference/pages/ConversationPage.tsx b/ui/astryx-reference/pages/ConversationPage.tsx index a5b78b59f..ed9e31fba 100644 --- a/ui/astryx-reference/pages/ConversationPage.tsx +++ b/ui/astryx-reference/pages/ConversationPage.tsx @@ -30,7 +30,6 @@ import {MetadataList, MetadataListItem} from '@astryxdesign/core/MetadataList'; import {useMediaQuery} from '@astryxdesign/core/hooks'; import {ResizeHandle, useResizable} from '@astryxdesign/core/Resizable'; import {Section} from '@astryxdesign/core/Section'; -import {Step, Stepper} from '@astryxdesign/core/Stepper'; import {Heading, Text} from '@astryxdesign/core/Text'; import {Toolbar} from '@astryxdesign/core/Toolbar'; import { @@ -41,34 +40,6 @@ import { import mark from '../../../assets/brand/archie-mark.svg?url'; const ARTIFACT_TITLE = 'Checkout rollback review'; -const EVIDENCE_TRAIL = [ - { - label: 'Hears', - description: 'The checkout alert fired after timeouts exceeded 5%.', - }, - { - label: 'Understands', - description: 'The 09:34 release is the leading timing suspect.', - }, - { - label: 'Decides', - description: 'A bounded rollback is proposed; policy requires approval.', - }, - { - label: 'Defines', - description: - 'The existing checkout rollback workflow supplies the exact bounded operation.', - }, - { - label: 'Does', - description: 'No production change has been made.', - }, - { - label: 'Delivers', - description: 'The outcome follows the operator decision in Runs.', - }, -] as const; - export type ConversationMessage = { id: string; sender: 'user' | 'assistant'; @@ -104,32 +75,6 @@ function RollbackArtifactBody({ : decision === 'approved' ? 'success' : 'neutral'; - const evidenceTrail = EVIDENCE_TRAIL.map((stage) => { - if (stage.label === 'Does') { - return { - ...stage, - description: - decision === 'approved' - ? 'The exact approved rollback ran in production.' - : decision === 'declined' - ? 'The operator declined the rollback; no production change was made.' - : stage.description, - }; - } - if (stage.label === 'Delivers') { - return { - ...stage, - description: - decision === 'approved' - ? 'Operations received the restored timeout rate and verification.' - : decision === 'declined' - ? 'Operations received the decision; the incident remains unresolved.' - : stage.description, - }; - } - return stage; - }); - return (
@@ -150,28 +95,6 @@ function RollbackArtifactBody({ - - Evidence trail - - {evidenceTrail.map((stage, index) => ( - - ))} - - - { id: string; title: string; @@ -74,20 +59,10 @@ interface Run extends Record { proposedAction: string; reversibility: string; policy: string; - stages: RunStage[]; } const PRIMARY_RUN_ID = 'RUN-2041'; -const STAGE_ORDER: StageName[] = [ - 'Hears', - 'Understands', - 'Decides', - 'Defines', - 'Does', - 'Delivers', -]; - const STATUS_ORDER: RunStatus[] = [ 'approval', 'completed', @@ -122,98 +97,6 @@ const STATUS_DOT_VARIANT: Record< declined: 'neutral', }; -const STAGE_STATE_LABEL: Record = { - complete: 'Complete', - waiting: 'Waiting', - blocked: 'Blocked', -}; - -const STAGE_STATE_TOKEN_COLOR: Record< - StageState, - 'green' | 'yellow' | 'gray' -> = { - complete: 'green', - waiting: 'yellow', - blocked: 'gray', -}; - -const STAGE_STATE_DOT_VARIANT: Record< - StageState, - 'success' | 'warning' | 'neutral' -> = { - complete: 'success', - waiting: 'warning', - blocked: 'neutral', -}; - -function checkoutStages(decision: RunDecision): RunStage[] { - const decisionState: StageState = - decision === 'declined' ? 'blocked' : decision === 'approved' ? 'complete' : 'waiting'; - - return [ - { - name: 'Hears', - detail: - 'Checkout monitoring reports a timeout-rate alert after the 09:34 release.', - state: 'complete', - }, - { - name: 'Understands', - detail: - 'Archie links the 8.1% timeout rise to the release; no other service shows a comparable rise.', - state: 'complete', - }, - { - name: 'Decides', - detail: - 'Archie recommends a checkout-only rollback to the last healthy release.', - state: 'complete', - }, - { - name: 'Defines', - detail: - 'The existing checkout rollback workflow defines the exact bounded operation: verify 4.9.0, roll back to 4.8.2, then verify recovery.', - state: 'complete', - }, - { - name: 'Does', - detail: - decision === 'approved' - ? 'The approved rollback reached production and the checkout version changed to 4.8.2.' - : decision === 'declined' - ? 'The operator declined the rollback. Archie made no production change.' - : 'Archie waits for the exact operator decision. No production change has been made.', - state: decisionState, - }, - { - name: 'Delivers', - detail: - decision === 'approved' - ? 'Operations received the result: timeout rate returned to 0.4% by 09:46 UTC.' - : decision === 'declined' - ? 'Operations received the decision record; the incident remains unresolved.' - : 'Delivery waits until the approval decision and any permitted action are resolved.', - state: decision === 'pending' ? 'waiting' : 'complete', - }, - ]; -} - -function resolvedStages(...details: string[]): RunStage[] { - return STAGE_ORDER.map((name, index) => ({ - name, - detail: details[index], - state: 'complete', - })); -} - -function failedStages(...details: string[]): RunStage[] { - return STAGE_ORDER.map((name, index) => ({ - name, - detail: details[index], - state: index === 4 ? 'blocked' : 'complete', - })); -} - const BASE_RUNS: Run[] = [ { id: PRIMARY_RUN_ID, @@ -233,7 +116,6 @@ const BASE_RUNS: Run[] = [ 'Moderate risk: checkout may briefly lose capacity during rollout. Release 4.9.0 can be reapplied. The database is unchanged.', policy: 'Read-only investigation is allowed. A production rollback needs operator approval. Database changes are blocked.', - stages: checkoutStages('pending'), }, { id: 'RUN-2040', @@ -253,14 +135,6 @@ const BASE_RUNS: Run[] = [ 'Low risk. The prior read projection remained available until the replacement passed validation.', policy: 'Rebuilding a derived projection is permitted. Changing source payment records requires separate approval.', - stages: resolvedStages( - 'The projection lag alert reported 18,420 stale payment documents.', - 'Archie verified source-event continuity and isolated the stale read model.', - 'Archie selected a full projection rebuild with no source-record mutation.', - 'The operation paused the reader, rebuilt it, and checked the newest document offset.', - 'The replacement projection rebuilt successfully without changing payment records.', - 'Payments received a freshness report with 0 documents outside the lag budget.', - ), }, { id: 'RUN-2039', @@ -280,14 +154,6 @@ const BASE_RUNS: Run[] = [ 'No delivery replay occurred. The retained queue can be reviewed without duplicating external side effects.', policy: 'External delivery is limited to approved destinations. The policy match must pass before replay starts.', - stages: failedStages( - 'The webhook queue alert reported 2,104 failed deliveries.', - 'Archie compared each destination with the active recovery allowlist.', - 'Archie separated approved destinations from two destinations needing review.', - 'The replay operation was constrained to the approved subset.', - 'Policy blocked the mixed-destination replay before any message left the queue.', - 'Operations received the failed-policy decision and the retained queue count.', - ), }, { id: 'RUN-2038', @@ -307,14 +173,6 @@ const BASE_RUNS: Run[] = [ 'Generation 40 remains retained and can be promoted again if parity checks regress.', policy: 'Staging cache promotion is permitted because it does not modify source data.', - stages: resolvedStages( - 'The freshness report identified warehouse cache generation 40 as stale.', - 'Archie compared source and cache generation metadata and found generation 41 intact.', - 'Archie chose a staged promotion with before-and-after parity checks.', - 'The operation promoted generation 41 and retained generation 40 as fallback.', - 'Staging switched to generation 41 and sample queries passed.', - 'Data Operations received the parity report and active generation.', - ), }, { id: 'RUN-2037', @@ -334,14 +192,6 @@ const BASE_RUNS: Run[] = [ 'The replacement remained behind the healthy pool until lease uniqueness passed; the old worker could be returned if needed.', policy: 'Worker replacement is permitted. Sending an ad hoc notification requires a separate workflow and grant.', - stages: resolvedStages( - 'The scheduler reported three missed heartbeats from notifications-7.', - 'Archie confirmed one retained lease and no customer-visible delay.', - 'Archie selected a worker rotation without changing notification content.', - 'The operation drained leases, started a replacement, and checked duplicate claims.', - 'The replacement joined the pool and every scheduled task had one active lease.', - 'Notifications Operations received the worker replacement and lease audit.', - ), }, { id: 'RUN-2036', @@ -361,14 +211,6 @@ const BASE_RUNS: Run[] = [ 'No membership update was applied. A renewed credential and a new run can reproduce the proposed difference set.', policy: 'Protected groups cannot be reconciled by this workflow. Credential renewal does not authorize protected membership changes.', - stages: failedStages( - 'The scheduled identity sync reported an expired service credential.', - 'Archie loaded the difference set and found four protected groups among 61 entries.', - 'Archie separated ordinary group changes from the protected group set.', - 'The operation required a renewed credential and an allowed destination scope.', - 'Policy stopped execution before the first membership write.', - 'Identity Operations received the scope and credential failure report.', - ), }, ]; @@ -435,7 +277,6 @@ function getRuns(decision: RunDecision): Run[] { : decision === 'approved' ? 'Rollback completed; checkout timeouts returned to 0.4%' : 'Operator declined the rollback; no production change was made', - stages: checkoutStages(decision), }; }); } @@ -519,28 +360,6 @@ function RunRows({ ); } -function StageDetail({stage}: {stage: RunStage}) { - return ( - - } - endContent={ - - } - /> - ); -} - function RunInspector({ run, decision, @@ -627,43 +446,6 @@ function RunInspector({ - - Run path - - {run.stages.map((stage, index) => ( - - - {index < run.stages.length - 1 && ( - - )} - - ))} - - - - - - - - - {run.stages.map(stage => ( - - ))} - - - - - Decision record @@ -825,7 +607,7 @@ export default function RunsPage({ ) : ( } isCompact /> @@ -838,7 +620,7 @@ export default function RunsPage({ } footer={ - + {composer} } @@ -861,7 +643,7 @@ export default function RunsPage({ ) : ( } isCompact />