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:13:48.706Z

Done Work Item

Cockpit Phase 2 — Exchange Activity panel on the dashboard

Implement the Exchange Activity panel on the /dashboard page as the Operator Cockpit Phase 2 cockpit surface. Panel shows: recent exchange record transitions (last 10 across all kinds and states), counts per canonical exchange state (candidate, triage, approved, packaged, applied, verified, blocked, rejected, superseded), quick-link to /reuse/promotions and /reuse/harvests for drilldown. Data source: GET /api/control-plane/exchange/summary. Panel must handle stale, empty, and error states independently without blocking dashboard render. No new exchange states may be introduced. Mobile: compact summary card.

bootstrapstate: done

Execution Context

ID
wi-BF-234
Branch
bf/BF-234-cockpit-exchange-activity-panel
Validation
./scripts/validate-local.ps1
PR
https://github.com/SingletonTheory/build-factory-bootstrap/pull/309

Lifecycle Metadata

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

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-234.prompt.md

Implement the Exchange Activity panel on the /dashboard page as the Operator Cockpit Phase 2 cockpit surface. Panel shows: recent exchange record transitions (last 10 across all kinds and states), counts per canonical exchange state (candidate, triage, approved, packaged, applied, verified, blocked, rejected, superseded), quick-link to /reuse/promotions and /reuse/harvests for drilldown. Data source: GET /api/control-plane/exchange/summary. Panel must handle stale, empty, and error states independently without blocking dashboard render. No new exchange states may be introduced. Mobile: compact summary card.

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-234/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-234/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-234/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-234/actions/record-history