Operator Frame

Global navigation, page frame, and live control-plane status.

The shell is intentionally persistent: left-side navigation, a shared header, and durable status surfaces remain stable while future workflow views swap in.

Lane

Done

Domain

bootstrap

State

done

Work Item

Typed detail boundary

Control-plane detail payloads expose explicit context, lane, approvals, execution state, and action metadata.

Snapshot 2026-03-27T08:10:03.225Z

Done Work Item

Deployments route and UI — /settings/deployments deployment history and health

Implement the /settings/deployments route showing deployment history and current environment health. Display: deployment history (list of recent deploys: image tag, deploy timestamp, deployed-by, health check result, rollback status), current environment status (running image version, uptime, DB connection health, last successful health check timestamp), manual deploy trigger (for admin role operators, triggers the deploy pipeline via API), rollback trigger (to previous known-good image, audited). Data sourced from: jobs table for deploy history, /api/health for current status, GitHub Actions API for pipeline status. All deploy and rollback actions audited.

bootstrapstate: done

Execution Context

ID
wi-BF-244
Branch
bf/BF-244-deployments-route-ui
Validation
./scripts/validate-local.ps1
PR
https://github.com/SingletonTheory/build-factory-bootstrap/pull/318

Lifecycle Metadata

Lane
Done
Work type
feature
Source
done
Status
done
State
done
Done criteria
8

Queue Truth

Freshness: Fresh (snapshot age 0s)

Drift: none.

Reconciliation Guidance

  • No reconciliation required; item truth signals are consistent.

Prompt Context

./work-items/prompts/wi-BF-244.prompt.md

Implement the /settings/deployments route showing deployment history and current environment health. Display: deployment history (list of recent deploys: image tag, deploy timestamp, deployed-by, health check result, rollback status), current environment status (running image version, uptime, DB connection health, last successful health check timestamp), manual deploy trigger (for admin role operators, triggers the deploy pipeline via API), rollback trigger (to previous known-good image, audited). Data sourced from: jobs table for deploy history, /api/health for current status, GitHub Actions API for pipeline status. All deploy and rollback actions audited.

Available Actions

  • Start executionBlocked

    Queue execution handoff for this work item.

    Recovery guidance

    Cause
    Done items stay closed; Start execution cannot move them backward.
    Policy context
    Lane transition policy blocks Start execution when the item is already Done.
    Next step
    Create a net-new work item if more delivery is needed instead of reopening this one.
    Safe retry
    Do not retry Start execution on a done item.

    identity: start-execution

    permission: factory.work-item.execute

    policy gate lane-transition: blocked (Done items stay closed; Start execution cannot move them backward.)

    POST /api/control-plane/items/wi-BF-244/actions/start-execution

  • Request reviewBlocked

    Mark this item ready for review lane handoff.

    Recovery guidance

    Cause
    Done items stay closed; Request review cannot move them backward.
    Policy context
    Lane transition policy blocks Request review when the item is already Done.
    Next step
    Create a net-new work item if more delivery is needed instead of reopening this one.
    Safe retry
    Do not retry Request review on a done item.

    identity: request-review

    permission: factory.work-item.request-review

    policy gate lane-transition: blocked (Done items stay closed; Request review cannot move them backward.)

    POST /api/control-plane/items/wi-BF-244/actions/request-review

  • Prepare releaseEnabled

    Run release-preparation checks for the work item.

    identity: prepare-release

    permission: factory.work-item.prepare-release

    policy gate lane-eligibility: pass

    policy gate pull-request: pass

    POST /api/control-plane/items/wi-BF-244/actions/prepare-release

  • Record historyEnabled

    Capture history snapshots for audit and validation views.

    identity: record-history

    permission: factory.work-item.record-history

    policy gate context-visibility: pass

    POST /api/control-plane/items/wi-BF-244/actions/record-history