gabriel / musehub public
_coordination-docs.scss
172 lines 6.1 KB
Raw
sha256:395afcc81bdadd355e87f50a1eb01b857ffdcce78f54635a77fe893ca7352528 docs(coordination): #251 Agent Coordination QA contract v2 … Opus 5.5 minor ⚠ breaking 9 days ago
1 // ── Claim lifecycle figure (musehub#251 V1) ──────────────────────────────────
2 // Used only by /muse/coordination inside the shared docs figure (.docfig, musehub#242 W7). A list of task
3 // states, then a transition table: one row per command or event that moves a task. Server-rendered and
4 // readable in DOM order without script, so the figure is its own text alternative. No motion. Theme tokens
5 // only. Accent and status tokens never colour text (below WCAG AA on the light theme, musehub#283): text stays
6 // on --text-primary/--text-secondary, and the tokens only draw borders and inset bars.
7
8 .crdfig {
9 display: grid;
10 gap: var(--space-4);
11 font-size: 13px;
12 color: var(--text-primary);
13 }
14
15 .crdfig__states {
16 list-style: none;
17 margin: 0;
18 padding: 0;
19 display: grid;
20 grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
21 gap: var(--space-2);
22 }
23
24 .crdfig__state {
25 min-width: 0;
26 padding: var(--space-2) var(--space-3);
27 border: 1px solid var(--border-default);
28 border-left: 3px solid var(--color-accent);
29 border-radius: 6px;
30 background: var(--bg-surface);
31 line-height: 1.45;
32
33 span { display: block; font-size: 12px; color: var(--text-secondary); }
34 }
35
36 .crdfig__state--derived { border-left-style: dashed; }
37 .crdfig__state--final { border-left-color: var(--color-success); }
38
39 .crdfig__table { // fixed columns that wrap, never a scrolling table: fits 320 px
40 width: 100%;
41 border-collapse: collapse;
42 table-layout: fixed;
43 font-size: 12px;
44
45 caption {
46 caption-side: top;
47 padding-bottom: var(--space-2);
48 text-align: left;
49 font-size: 13px;
50 color: var(--text-secondary);
51 }
52
53 th,
54 td {
55 padding: 6px 8px;
56 border-bottom: 1px solid var(--border-subtle);
57 text-align: left;
58 vertical-align: top;
59 line-height: 1.5;
60 color: var(--text-primary);
61 overflow-wrap: anywhere;
62 }
63
64 // The generic th style uppercases text, which would rewrite the state names: reset it.
65 th { letter-spacing: normal; text-transform: none; }
66 thead th { font-size: 11px; font-weight: 600; color: var(--text-secondary); }
67 tbody th { font-weight: 400; }
68 thead th:nth-child(1) { width: 27%; }
69 thead th:nth-child(3) { width: 18%; }
70
71 @media (max-width: 480px) {
72 font-size: 11px;
73 th, td { padding: 6px 3px; overflow-wrap: break-word; }
74 code { font-size: 10px; }
75 }
76 }
77
78 .crdfig__ok { box-shadow: inset 3px 0 0 var(--color-success); }
79 .crdfig__warn { box-shadow: inset 3px 0 0 var(--color-warning); font-weight: 600; }
80
81 .docfig .crdfig__note {
82 margin: 0;
83 font-size: 12px;
84 line-height: 1.55;
85 color: var(--text-secondary);
86 }
87
88 .docfig .crdfig code {
89 padding: 0 4px;
90 border: 1px solid var(--border-default);
91 border-radius: 4px;
92 background: var(--bg-overlay);
93 color: var(--text-primary);
94 font-family: var(--font-mono);
95 font-size: 11px;
96 white-space: normal;
97 overflow-wrap: anywhere;
98 }
99
100 .docfig .crdfig a {
101 color: var(--text-primary);
102 text-decoration: underline;
103 text-underline-offset: 2px;
104 &:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
105 }
106
107 @media (forced-colors: active) {
108 .crdfig__state { border-color: CanvasText; border-left-color: Highlight; }
109 .crdfig__ok,
110 .crdfig__warn { box-shadow: none; }
111 .crdfig__warn { text-decoration: underline; }
112 }
113
114 // The shared docs styles are below WCAG AA as text on this page (musehub#283): callout links and inline code,
115 // table headers and the muted second column, prose links, code-block text and header labels. Scoped to this
116 // page as an interim, like the shelves and merge pages; delete when #283 fixes the tokens.
117 .devdocs--coord .devdocs-callout {
118 a {
119 color: var(--text-primary);
120 text-decoration: underline;
121 text-underline-offset: 2px;
122 &:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
123 }
124 code { color: var(--text-primary); }
125 }
126
127 .devdocs--coord .devdocs-table {
128 thead th { color: var(--text-secondary); }
129 td { color: var(--text-primary); }
130 td code { color: var(--text-primary); }
131 }
132
133 .devdocs--coord .devdocs-section :is(p, li, td) a {
134 color: var(--text-primary);
135 text-decoration: underline;
136 text-underline-offset: 2px;
137 &:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
138 }
139
140 .devdocs--coord .devdocs-section :is(p, li) code { color: var(--text-primary); }
141 .devdocs--coord .devdocs-code-block pre,
142 .devdocs--coord .devdocs-code-block pre code { color: var(--text-primary); }
143 .devdocs--coord .devdocs-code-header :is(.devdocs-code-lang, .devdocs-code-label) { color: var(--text-secondary); }
144
145 // Long unbreakable addresses (src/billing.py::compute_invoice_total) must wrap inside callouts and cells on a phone.
146 .devdocs--coord :not(pre) > code { overflow-wrap: anywhere; }
147 .devdocs--coord .devdocs-callout > div { min-width: 0; }
148
149 // The shared syntax colours in .devdocs-code-block are fixed One Dark hex values (_devdocs.scss), not theme
150 // tokens: comments are 3.1:1 on the dark theme and every token is 2.0–2.5:1 on the light theme (musehub#288).
151 // Interim, scoped to this page: comments use the secondary text role; on the light theme all tokens use the primary
152 // text role (comments stay italic). Delete when the shared palette is fixed.
153 .devdocs--coord .devdocs-code-block .tok-cmt { color: var(--text-secondary); }
154 .devdocs--coord .devdocs-code-block--output .tok-kw { color: var(--text-primary); } // null/true: 4.49:1 on --bg-void (dark)
155 [data-theme="light"] .devdocs--coord .devdocs-code-block :is(.tok-kw, .tok-str, .tok-num, .tok-key, .tok-fn, .tok-type, .tok-var, .tok-punc, .tok-acc) {
156 color: var(--text-primary);
157 }
158
159 // The known-issues table wraps instead of scrolling inside the page on a phone (the shared table is display:block).
160 .devdocs--coord .crdissues {
161 width: 100%;
162 table-layout: fixed;
163 display: table;
164 overflow: visible;
165
166 th, td { overflow-wrap: anywhere; vertical-align: top; }
167 th { text-transform: none; letter-spacing: normal; }
168 td:nth-child(2) { font-family: inherit; }
169 thead th:nth-child(1) { width: 26%; }
170 thead th:nth-child(3) { width: 26%; }
171 @media (max-width: 480px) { font-size: 11px; th, td { padding: 6px 3px; } }
172 }
File History 1 commit
sha256:395afcc81bdadd355e87f50a1eb01b857ffdcce78f54635a77fe893ca7352528 docs(coordination): #251 Agent Coordination QA contract v2 … Opus 5.5 minor ⚠ 9 days ago