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:09:09.941Z

Done Work Item

Slice 2: Canonical work-item type contracts

Create operator-cockpit/lib/contracts/work-item.ts and action-envelope.ts defining the canonical 15-state lifecycle model (intake, triage, approved, planned, in_progress, awaiting_review, changes_requested, ready_to_merge, merged, ready_to_release, released, done, blocked, failed, canceled) as TypeScript types. Also define WorkItemLane, WorkItemRef, ActionRequest, ActionResult, and ScopeRef contracts to establish the foundation for query API, mapping adapter, and UI work in BF-148-BF-151.

bootstrapstate: done

Execution Context

ID
wi-BF-147
Branch
bf/BF-147-Slice-2-Canonical-work-item-type-contracts
Validation
./scripts/validate-local.ps1
PR
https://github.com/SingletonTheory/build-factory-bootstrap/pull/146

Lifecycle Metadata

Lane
Done
Work type
implementation
Source
done
Status
done
State
done
Done criteria
2

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

Create operator-cockpit/lib/contracts/work-item.ts and action-envelope.ts defining the canonical 15-state lifecycle model (intake, triage, approved, planned, in_progress, awaiting_review, changes_requested, ready_to_merge, merged, ready_to_release, released, done, blocked, failed, canceled) as TypeScript types. Also define WorkItemLane, WorkItemRef, ActionRequest, ActionResult, and ScopeRef contracts to establish the foundation for query API, mapping adapter, and UI work in BF-148-BF-151.

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