docs: add pricing check command, OverviewPage hero/filters, and UI deep-link reference#58
Draft
cursor[bot] wants to merge 1 commit into
Draft
docs: add pricing check command, OverviewPage hero/filters, and UI deep-link reference#58cursor[bot] wants to merge 1 commit into
cursor[bot] wants to merge 1 commit into
Conversation
…ep-link reference - docs/cli.md: add flightdeck pricing check section (--max-age-days, --fail, output format, CI use note); links back to pricing-catalog.md staleness guardrails - docs/web-ui.md: update routing table with URL search params for all pages (#/ ?release=, #/diff ?baseline/candidate/window/environment, #/runs ?release_id, #/actions ?release_id/environment/window); add deep-link explanation paragraph - docs/web-ui.md: rewrite OverviewPage section to document focused-release hero, release table client-side filters, collapsible ledger metrics panel, ReleaseLifecycleStrip - docs/web-ui.md: add urlSearch.ts section (pickTrimmedSearch, searchParamsFromRecord) - docs/web-ui.md: add CopyTextButton and ReleaseLifecycleStrip to shared components - docs/web-ui.md: add new CSS utility classes to token table (fd-lifecycle-strip, fd-release-hero, fd-copy-btn, fd-card--collapse, fd-collapse-head, fd-filter-row, fd-table-toolbar, fd-table-actions, fd-cell-stack, fd-cell-inline) Co-authored-by: Gottam Sai Bharath <Gsbreddy@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation-only PR. Updates two doc files to cover recently shipped features that had no written documentation.
Why
Several features shipped in v1.2.0 and adjacent PRs (pricing staleness tooling, OverviewPage focused-release hero, URL deep-linking, ReleaseLifecycleStrip, CopyTextButton) were undocumented or only partially referenced. This PR fills those gaps without inventing behavior — everything is verified against the source code.
Changes
docs/cli.mdflightdeck pricing checkcommand section:--max-age-days(default 90),--failflag, output format (OK/STALE), and CI use note. Links back topricing-catalog.mdstaleness guardrails.docs/web-ui.md#/?release=<id>,#/diff?baseline=…&candidate=…&window=…&environment=…,#/runs?release_id=…,#/actions?release_id=…); add deep-link explanation paragraph that calls out shortcut link generation in the releases table and the focused-release hero.OverviewPagesection: document the focused-release hero (?release=<id>URL param, hero content, action buttons, unknown-ID warning), release table client-side filters (agent / env / promotion status), and the collapsible ledger metrics panel.urlSearch.tssection: documentspickTrimmedSearchandsearchParamsFromRecordwith usage pattern.CopyTextButtonto shared components: props table, clipboard fallback behavior, and usage context.ReleaseLifecycleStripto shared components: step table,UI_READ_ONLYbehavior, no-API-call note.fd-lifecycle-strip,fd-release-hero,fd-copy-btn,fd-card--collapse,fd-collapse-head,fd-collapse-body,fd-filter-row,fd-table-toolbar,fd-table-actions,fd-cell-stack,fd-cell-inline.Validation
uv run python -m ruff check src tests— all checks passeduv run python -m pytest— 139 passed, 4 skippeduv run python scripts/generate_schemas.pythengit diff --exit-code schemas/— clean (no schema changes)web/source changes; no static bundle rebuild neededSchema / Storage Impact
Risk
Documentation only. No code, schema, or bundle changes.
Notes
Codepaths covered:
src/flightdeck/cli/main.py(pricing checkcommand),src/flightdeck/bundled_pricing_age.py,web/src/pages/OverviewPage.tsx,web/src/components/ReleaseLifecycleStrip.tsx,web/src/components/CopyTextButton.tsx,web/src/urlSearch.ts.