LearnNewsExamplesServices
Frontmatter
id14605
titleFM cockpit card contract: consolidate the fleet-card definition under the design SSOT
stateClosed
labels
documentationenhancementdeveloper-experienceai
assigneesneo-opus-vega
createdAt4:26 AM
updatedAt11:01 AM
githubUrlhttps://github.com/neomjs/neo/issues/14605
authorneo-opus-vega
commentsCount0
parentIssue14560
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAt11:01 AM

FM cockpit card contract: consolidate the fleet-card definition under the design SSOT

Closed Backlog/active-chunk-3 documentationenhancementdeveloper-experienceai
neo-opus-vega
neo-opus-vega commented on 4:26 AM

Context

T1.6 of Epic #14560 (map v1.1) — unblocked tonight by the #14560/#13448 reconciliation closing (recorded by both stewards, 2026-07-04: floor stays #13448, forward design → #14560 under the SSOT authority). This leaf executes the split's card-side consequence: the fleet-card contract (what a card renders, from which fields, under which render rules) gets one consolidated home in this epic's orbit.

The Problem

Card-definition fragments live in three places: the SSOT artifact's §01 card anatomy (visual), #13448's earlier keeper-view definition work (pre-split), and ADR 0032 §2.3's render rules (schema/render/feedback constraints, PR #14583). The AgentCard implementation leaf (#14598) needs ONE citable contract — without consolidation, each fragment drifts independently and the anti-lock-in fixtures lose their single source.

The Architectural Reality

  • The contract is a document leaf (design-system tier), placed per the #14577 namespace gate (candidate: a design/ sibling of the SSOT artifact).
  • Contents: field table (identity id · display-name + provenance slot · engine tag as era-metadata · state · lane line · foot meta · controls slot) · data-source per field (roster DTO #14571 / runtime-status #14595 / episode data when #11318 lands) · the ADR 0032 bindings stated per field (name≠key · family-as-episode-attribute · state-never-identity) · freshness/degrade rules per the #13444 ledger discipline.
  • Anything #13448 retains (harness shell/nav definitions) is explicitly OUT — the split's boundary, cited.

The Fix

One PR: the card-contract document + a conformance checklist the #14598 spec suite consumes (each contract row → one fixture). Deltas from the SSOT artifact = recorded design decisions per the epic rule.

Acceptance Criteria

  • One contract doc: field table + per-field source + per-field ADR 0032 binding + degrade rule.
  • #13448-retained scope explicitly listed as out (the split boundary, cited to both stewards' closure).
  • Conformance checklist maps 1:1 to #14598's planned fixtures.
  • Design-authority review (Grace) recorded before merge.

Out of Scope

The AgentCard implementation (#14598 consumes this) · shell/nav definitions (#13448) · token values (#14578).

Related

Epic #14560 (parent) · #13448 (split counterpart) · #14598 (consumer) · ADR 0032 / PR #14583 · #14571/#14595 (field sources) · D#14561.

Live latest-open sweep: fold-window fresh (newest known #14604 PR / #14603); no equivalent. A2A sweep: split-closure recorded by both stewards; no competing claim. Structure-map gate: N/A — design-doc leaf.

Origin Session ID: a28f1415-37a4-4a5a-a3e4-b56adf6274ec Retrieval Hint: "FM cockpit card contract consolidation split closure field table"

tobiu referenced in commit cbf5faf - "docs(agentos): AgentCard contract (#14605) (#14627) on 11:01 AM
tobiu closed this issue on 11:01 AM