Developer preview. Pre-admission. Not for sensitive, proprietary, regulated, or production code. Expect breaking changes and data loss. Read the limits.

Floor status

This page shows the last generated snapshot of the floor and its promotion pair. The snapshot is generated at build or publication time. It does not stream, poll GitHub from your browser, hold a token, or guarantee that it is newer than the source.

A status page is not an audit. Bridlewise is an experimental developer preview, not production-ready and not safe for sensitive code. An unknown or stale field is not a pass.

Generated data. This page loads status.json, generated from the tracked floor and public GitHub state at build time. The generator, page script, and fallback states are part of this repository. Until a valid snapshot is deployed, the page shows its unavailable state. The page never invents a run, a commit, or a green result.

Read the snapshot

Reading the last generated status snapshot. Fields appear only after the file parses. A blank field during loading is not a result. If this message remains, the page script did not run; read the raw JSON or use the evidence commands.

Fields

The snapshot is a versioned JSON document. The page accepts bridlewise-floor-status/v1 and rejects an unknown schema instead of guessing. The public snapshot carries no local paths, host names, tokens, or environment values.

Field Type Meaning Unknown or empty behavior
schemaVersion string The document schema. The page accepts bridlewise-floor-status/v1 only. An unknown schema is an error state.
generatedAt ISO 8601 string When the snapshot was produced, not when you loaded the page. Missing means the age is unknown; the page does not apply the stale check.
source.repository string The repository the snapshot read. Missing means unknown.
source.ref string The source ref, refs/heads/main. Missing means unknown.
source.commit string or null The source commit in the snapshot. null means unknown, not current.
source.committedAt ISO 8601 string or null The source commit time. null means unknown.
product.repository string The repository whose product branch the snapshot read (the same repository). Missing means unknown.
product.ref string The product branch, refs/heads/product. Missing means unknown.
product.commit string or null The product branch’s tip in the snapshot. null means unknown or no promotion yet, not current.
product.committedAt ISO 8601 string or null The product commit time. null means unknown.
promotion.profile string The profile name that produced the state. Missing means unknown.
promotion.state enum ready, blocked, or unknown. An unrecognized value renders unknown.
promotion.pending.commits integer or null Source commits not yet on the target. null means no target yet or unknown.
promotion.pending.oldestPendingAgeHours number or null Age of the oldest pending source commit. null means none or unknown.
promotion.hold object or null { "at": ISO 8601, "reason": string } when automatic promotion is paused. null means no hold is recorded, not that a hold never happened.
promotion.lastRun object or null The last recorded promotion run, when one is available. null means no run is recorded. The public snapshot does not invent one.
promotion.lastRun.code string A promotion code, when a run is recorded. Missing means unknown.
promotion.reason string Why this public snapshot is not a release gate. Missing means unknown.
checks array Gate results: { "id", "label", "status", "durationMs" }. An empty array means no gate results, not a pass.
checks[].status enum pass, fail, unknown, or not-run. unknown and not-run are not passes.
github.available boolean True only when the generator received GitHub API data for every requested run. Missing means unknown. Do not infer true from an empty runs array.
github.checkedAt ISO 8601 string or null The last API attempt. null means the attempt time is unknown.
github.reason string or null A short public reason when available is false, for example rate-limit, no-token, network, or api-error. null with available: false means the reason is unknown.
github.runs array Latest public runs: { "repository", "workflow", "runId", "status", "conclusion", "headSha", "url" }. An empty array means no runs were read, not that none exist.
github.runs[].conclusion string or null GitHub’s conclusion for that run, such as success, failure, cancelled, or skipped. null means running or unknown.

Nested fields the table groups for space:

Promotion states

State Meaning
ready Every required run in this snapshot passed at the recorded commit. It is not a release authorization.
blocked At least one required run failed. Read the gate table and the public run.
unknown A required run is missing, pending, or for a different commit, or the API could not be read. This is not a pass.

The public snapshot does not authorize a release: a release is judged from its own attested evidence when it is cut. This page reports public evidence and gaps.

The GitHub fallback

The generator fills github from the public GitHub API. The API can be rate-limited, unreachable, or unauthenticated at build time. The fallback is deliberate:

If the status file itself cannot be read, the page shows its error state. If the file parses but a field is missing, that field renders unknown. If the file predates the deployed page beyond the build window, the page labels the snapshot as stale. A stale snapshot is history, not current status.

The generator runs where the promotion refs exist. If the public Pages build does not carry those refs, it cannot produce the promotion block. The page then reports unknown, not idle. The integration notes define the generation boundary.

What the snapshot cannot tell you

If the snapshot and a command disagree, the command wins. Use the evidence commands for the claim you need to repeat.

The logbook index

Search the record

Type to search the curated record.

↑↓ move Enter open Esc close