@bongos/core 1.19.725 → 1.19.727

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (229) hide show
  1. package/.bongos-core.json +179 -494
  2. package/.devcontainer/Dockerfile +1 -1
  3. package/.devcontainer/devcontainer.json +2 -2
  4. package/.devcontainer/healthcheck.sh +1 -1
  5. package/.devcontainer/init-firewall.sh +1 -1
  6. package/.devcontainer/post-create.sh +2 -2
  7. package/.env.local.example +1 -1
  8. package/Dockerfile +1 -1
  9. package/docs/copy-inventory.md +1 -1
  10. package/docs/copy-registry.json +9 -9
  11. package/docs/module-api-changelog.md +4 -0
  12. package/docs/recipes/devbox-app-release.md +4 -4
  13. package/modules/dev-box/app/scripts/dmgbuild-settings.py +5 -5
  14. package/modules/dev-box/app/scripts/gen-brand.js +1 -1
  15. package/modules/dev-box/app/src/brand.js +1 -1
  16. package/modules/dev-box/app/test/unit.mjs +16 -16
  17. package/modules/dev-box/box-access.js +1 -1
  18. package/modules/dev-box/routes/box.js +1 -1
  19. package/modules/discord/discord-approvals.js +1 -1
  20. package/modules/grading/grader-model.js +1 -1
  21. package/modules/grading/grader-prompt.js +1 -1
  22. package/modules/grading/grader-workers/quality.js +1 -1
  23. package/modules/hall-ui/module.json +1 -1
  24. package/modules/hall-ui/public/brand-apply.js +1 -1
  25. package/modules/hall-ui/public/shell.js +1 -1
  26. package/modules/hall-ui/public/work.js +1 -1
  27. package/modules/lifecycle/conflict-resolve.js +1 -1
  28. package/modules/lifecycle/db-analytics.js +1 -1
  29. package/modules/lifecycle/routes/analytics.js +1 -1
  30. package/modules/onboarding/approval-broadcast.js +1 -1
  31. package/modules/onboarding/onboarding.js +1 -1
  32. package/modules/provisioning/tests/liveness.mjs +1 -1
  33. package/modules/public-landing/public/index.html +1 -1
  34. package/modules/public-landing/public/projects-floor.states.json +2 -2
  35. package/modules/public-landing/public/projects.probes.json +4 -4
  36. package/modules/public-landing/public/projects.states.json +2 -2
  37. package/modules/status-ui/module.json +1 -1
  38. package/modules/status-ui/public/status.js +4 -4
  39. package/modules/status-ui/public/style.css +1 -1
  40. package/modules/ui-design/kit/fixtures/cost-summary.json +1 -1
  41. package/modules/ui-design/kit/fixtures/featured-hub.json +1 -1
  42. package/modules/ui-design/kit/fixtures/featured.json +1 -1
  43. package/modules/ui-design/kit/fixtures/leaderboard.json +1 -1
  44. package/modules/ui-design/kit/fixtures/my-projects.json +1 -1
  45. package/modules/ui-design/kit/fixtures/progress.json +1 -1
  46. package/modules/ui-design/kit/fixtures/recent-shipped.json +1 -1
  47. package/package-lock.json +2 -2
  48. package/package.json +1 -1
  49. package/scripts/cron/style_guide_audit.sh +1 -1
  50. package/scripts/discord/lib.js +1 -1
  51. package/scripts/discord/post.js +1 -1
  52. package/scripts/gds/audit-authorship.sh +1 -1
  53. package/scripts/gds/audit-replay.sh +29 -2
  54. package/scripts/gds/audit-ships.js +1 -1
  55. package/scripts/gds/backfill-sessions.js +2 -2
  56. package/scripts/gds/cf-tunnel.js +4 -4
  57. package/scripts/gds/claude-materialize.js +2 -2
  58. package/scripts/gds/cli-lib.js +6 -6
  59. package/scripts/gds/cutover-codemod.js +1 -1
  60. package/scripts/gds/dev-lib.js +2 -2
  61. package/scripts/gds/diagnose-achievements.js +2 -2
  62. package/scripts/gds/fitness-checks-identity.js +6 -4
  63. package/scripts/gds/gate-review.js +14 -6
  64. package/scripts/gds/gen-diagrams.js +1 -1
  65. package/scripts/gds/leak-scan-allowlist.js +293 -0
  66. package/scripts/gds/learning-capture.js +1 -1
  67. package/scripts/gds/linkify-refs.js +2 -2
  68. package/scripts/gds/local-preview-lib.js +1 -1
  69. package/scripts/gds/mirror-lineage-check.js +1 -1
  70. package/scripts/gds/mirror-redact.js +17 -2
  71. package/scripts/gds/newcomer-floor.templates.json +1 -1
  72. package/scripts/gds/package-core.js +18 -1
  73. package/scripts/gds/paste-token.js +1 -1
  74. package/scripts/gds/provision-units.js +2 -2
  75. package/scripts/gds/publish-manifest.js +15 -0
  76. package/scripts/gds/repo-metrics.js +1 -1
  77. package/scripts/gds/sandbox-stage.js +1 -1
  78. package/scripts/gds/seed-bongos-coreB-tranche1-tasks.js +1 -1
  79. package/scripts/gds/seed-bongos-coreB-tranche2-tasks.js +1 -1
  80. package/scripts/gds/seed-bongos-goal-hierarchy-tasks.js +1 -1
  81. package/scripts/gds/seed-bongos-tasks.js +2 -2
  82. package/scripts/gds/seed-gds-v4-tasks.js +1 -1
  83. package/scripts/gds/seed-medusa-tasks.js +10 -10
  84. package/scripts/gds/seed-module-upstreaming.js +1 -1
  85. package/scripts/gds/seed-productization-tasks.js +6 -6
  86. package/scripts/gds/seed-provisioning-tasks.js +2 -2
  87. package/scripts/gds/seed-staging.sh +19 -6
  88. package/scripts/gds/ship-deploy-target.js +1 -1
  89. package/scripts/gds/ship-flow.js +1 -1
  90. package/scripts/gds/smoke-gds.js +1 -1
  91. package/scripts/status-probe.mjs +2 -2
  92. package/src/bongos/auth-discord.js +2 -2
  93. package/src/bongos/live-channel.js +1 -1
  94. package/src/bongos/permission-path-check.js +80 -3
  95. package/src/bongos/pool.js +1 -1
  96. package/src/bongos/routes/auth.js +11 -11
  97. package/src/bongos/routes/security.js +1 -1
  98. package/src/bongos/routes.js +1 -1
  99. package/src/branding.js +1 -1
  100. package/src/devbox-downloads.js +1 -1
  101. package/src/instance-config.js +2 -2
  102. package/src/module-api.js +1 -1
  103. package/src/module-loader/provenance.js +2 -2
  104. package/tests/art_stage.mjs +2 -2
  105. package/tests/auth_anthropic_identity.mjs +1 -1
  106. package/tests/auth_duplicate_cookie.mjs +1 -1
  107. package/tests/auth_error_brand.mjs +1 -1
  108. package/tests/auth_inactive_builder.mjs +1 -1
  109. package/tests/backup_cli.mjs +4 -4
  110. package/tests/bongos_box_connect.mjs +2 -2
  111. package/tests/bongos_downloads.mjs +2 -2
  112. package/tests/bongos_login.mjs +5 -5
  113. package/tests/box_connect_e2e.mjs +2 -2
  114. package/tests/box_dns_repoint.mjs +10 -10
  115. package/tests/box_host_keys.mjs +1 -1
  116. package/tests/box_onboard.mjs +9 -9
  117. package/tests/box_scope_session.mjs +1 -1
  118. package/tests/box_terminal_ssrf.mjs +7 -7
  119. package/tests/boxes.mjs +9 -9
  120. package/tests/branding.mjs +2 -2
  121. package/tests/bump_version.mjs +2 -2
  122. package/tests/cf_tunnel.mjs +40 -40
  123. package/tests/cli_token_reissue.mjs +7 -7
  124. package/tests/cloud_bongos_pack.mjs +1 -1
  125. package/tests/currency_label.mjs +8 -8
  126. package/tests/dev_lib.mjs +4 -4
  127. package/tests/devbox_dmg_backdrop.mjs +1 -1
  128. package/tests/devbox_downloads.mjs +2 -2
  129. package/tests/devbox_icons.mjs +1 -1
  130. package/tests/discord_approvals.mjs +1 -1
  131. package/tests/discord_oauth.mjs +2 -2
  132. package/tests/executed_closure.mjs +6 -1
  133. package/tests/first_admin_bootstrap.mjs +1 -1
  134. package/tests/gate_approvals.mjs +5 -5
  135. package/tests/government_protected_surfaces.mjs +137 -0
  136. package/tests/grade_aggregates_unavailable.mjs +1 -1
  137. package/tests/hook_user_agents.mjs +2 -2
  138. package/tests/init.mjs +6 -6
  139. package/tests/instance_config.mjs +1 -1
  140. package/tests/instance_manifest.mjs +5 -5
  141. package/tests/instance_mismatch_guard.mjs +13 -13
  142. package/tests/leak_scan_allowlist.mjs +94 -0
  143. package/tests/migrate_root_resolution.mjs +4 -4
  144. package/tests/mirror_redact.mjs +28 -4
  145. package/tests/module_catalog.mjs +5 -5
  146. package/tests/module_submissions.mjs +3 -3
  147. package/tests/package_core.mjs +1 -1
  148. package/tests/parallel-load.mjs +6 -6
  149. package/tests/projects_hub.mjs +2 -2
  150. package/tests/provision.mjs +50 -50
  151. package/tests/provisioning_github_app_routes.mjs +1 -1
  152. package/tests/provisioning_onboard_mode.mjs +2 -2
  153. package/tests/publish_reconciler.mjs +4 -4
  154. package/tests/sandbox_stage.mjs +1 -1
  155. package/tests/scrubber_corpus.mjs +3 -3
  156. package/tests/search_isolation.mjs +1 -1
  157. package/tests/session_records.mjs +1 -1
  158. package/tests/ship_card.mjs +6 -6
  159. package/tests/ship_ci_deploy.mjs +1 -1
  160. package/tests/single_host_hall.mjs +9 -9
  161. package/tests/smoke_preflight.mjs +1 -1
  162. package/tests/smoke_target.mjs +1 -1
  163. package/tests/status-probe.mjs +1 -1
  164. package/tests/status_mirror_sync.mjs +1 -1
  165. package/docs/adr/0004-amazonprimea-name-and-trademark-acceptance.md +0 -45
  166. package/docs/design/mocks/_schemes.css +0 -604
  167. package/docs/design/mocks/component-sheet.html +0 -428
  168. package/docs/design/mocks/hall/_tokens.css +0 -370
  169. package/docs/design/mocks/hall/board/v1.html +0 -846
  170. package/docs/design/mocks/hall/board/v2.html +0 -858
  171. package/docs/design/mocks/hall/board/v3.html +0 -884
  172. package/docs/design/mocks/hall/goals/v1.html +0 -1212
  173. package/docs/design/mocks/hall/goals/v2.html +0 -1192
  174. package/docs/design/mocks/hall/goals/v3.html +0 -1205
  175. package/docs/design/mocks/hall/hall-sheet.html +0 -244
  176. package/docs/design/mocks/hall/reading/v1.html +0 -1125
  177. package/docs/design/mocks/hall/reading/v2.html +0 -1177
  178. package/docs/design/mocks/hall/reading/v3.html +0 -1150
  179. package/docs/design/mocks/hall/settings/v1.html +0 -1238
  180. package/docs/design/mocks/hall/settings/v2.html +0 -1235
  181. package/docs/design/mocks/hall/settings/v3.html +0 -1299
  182. package/docs/design/mocks/hall/task/v1.html +0 -633
  183. package/docs/design/mocks/hall/task/v2.html +0 -646
  184. package/docs/design/mocks/hall/task/v3.html +0 -647
  185. package/docs/design/mocks/hub/assets/r3-space-deepfield-half.jpg +0 -0
  186. package/docs/design/mocks/hub/assets/r3-space-deepfield-half.jpg.json +0 -13
  187. package/docs/design/mocks/hub/assets/r3-space-dust-half.jpg +0 -0
  188. package/docs/design/mocks/hub/assets/r3-space-dust-half.jpg.json +0 -13
  189. package/docs/design/mocks/hub/assets/r3-space-nebula-half.jpg +0 -0
  190. package/docs/design/mocks/hub/assets/r3-space-nebula-half.jpg.json +0 -13
  191. package/docs/design/mocks/hub/assets/r3-space-starfield-half.jpg +0 -0
  192. package/docs/design/mocks/hub/assets/r3-space-starfield-half.jpg.json +0 -13
  193. package/docs/design/mocks/hub/hub-sheet.html +0 -192
  194. package/docs/design/mocks/hub/mine.html +0 -465
  195. package/docs/design/mocks/hub/picker.html +0 -421
  196. package/docs/design/mocks/hub/planets.html +0 -356
  197. package/docs/design/mocks/hub/v1.html +0 -1209
  198. package/docs/design/mocks/hub/v2.html +0 -1257
  199. package/docs/design/mocks/hub/v3.html +0 -1496
  200. package/docs/design/mocks/hub/wizard.html +0 -421
  201. package/docs/design/mocks/landing/landing-sheet.html +0 -131
  202. package/docs/design/mocks/landing/v1.html +0 -956
  203. package/docs/design/mocks/landing/v2.html +0 -708
  204. package/docs/design/mocks/landing/v3.html +0 -911
  205. package/docs/design/mocks/landing-page-mock.html +0 -687
  206. package/docs/design/mocks/landing-palettes.html +0 -103
  207. package/docs/design/mocks/projects-hub-mock.html +0 -991
  208. package/docs/design/mocks/projects-hub-variants.html +0 -146
  209. package/docs/design/mocks/projects-page-mock.html +0 -167
  210. package/docs/design/mocks/world/blue-hud/_tokens.css +0 -246
  211. package/docs/design/mocks/world/blue-hud/hall.html +0 -595
  212. package/docs/design/mocks/world/blue-hud/landing.html +0 -424
  213. package/docs/design/mocks/world/blue-hud/status.html +0 -410
  214. package/docs/design/mocks/world/chrome-blobs/_tokens.css +0 -479
  215. package/docs/design/mocks/world/chrome-blobs/hall.html +0 -553
  216. package/docs/design/mocks/world/chrome-blobs/landing-b.html +0 -581
  217. package/docs/design/mocks/world/chrome-blobs/landing.html +0 -328
  218. package/docs/design/mocks/world/chrome-blobs/status.html +0 -416
  219. package/docs/design/mocks/world/natgeo-editorial/_tokens.css +0 -377
  220. package/docs/design/mocks/world/natgeo-editorial/hall.html +0 -649
  221. package/docs/design/mocks/world/natgeo-editorial/landing-b.html +0 -743
  222. package/docs/design/mocks/world/natgeo-editorial/landing.html +0 -475
  223. package/docs/design/mocks/world/natgeo-editorial/status.html +0 -437
  224. package/docs/design/mocks/world/organic-cards/_tokens.css +0 -462
  225. package/docs/design/mocks/world/organic-cards/hall.html +0 -625
  226. package/docs/design/mocks/world/organic-cards/landing-b.html +0 -736
  227. package/docs/design/mocks/world/organic-cards/landing.html +0 -420
  228. package/docs/design/mocks/world/organic-cards/status.html +0 -458
  229. package/docs/design/mocks/world/world-sheet.html +0 -156
package/docs/design/mocks/hall/reading/v1.html DELETED
@@ -1,1125 +0,0 @@
1
- <!doctype html>
2
- <html lang="en" data-mode="dark" data-theme="dark">
3
- <head>
4
- <meta charset="utf-8">
5
- <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <title>Reading room, the hall in the world: v1 "the ledger" (task 1003302)</title>
7
- <link rel="icon" href="data:,">
8
- <link rel="preconnect" href="https://fonts.googleapis.com">
9
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
- <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400&family=Manrope:wght@300;400;500;600&display=swap">
11
- <link rel="stylesheet" href="../_tokens.css">
12
- <style>
13
- /* ---------------------------------------------------------------------------
14
- READING ROOM, v1 "the ledger". The article is set on the page ground itself:
15
- no sheet, no card, no fill anywhere. Structure is carried entirely by
16
- hairlines that run the FULL content width while the prose stays measured to
17
- 58 characters, so the eye reads a narrow column inside a wide ruled page, the
18
- shape of a ledger. Every composition token lives on body, never on :root; every colour
19
- resolves from ../_tokens.css.
20
- --------------------------------------------------------------------------- */
21
-
22
- *, *::before, *::after { box-sizing: border-box; }
23
- html { -webkit-text-size-adjust: 100%; }
24
-
25
- body {
26
- /* ---- the composition tokens for v1 ---- */
27
- --gutter: 34px;
28
- --shell-pad: 22px;
29
- --toc-w: 232px;
30
- --col-gap: 56px;
31
- /* the measure is set in ch, but a `ch` is Manrope's ZERO, which is much wider
32
- than its average lowercase: 58ch measured 72 rendered characters. These are
33
- tuned against the rendered count, which is what the world's 56 to 62 means. */
34
- --measure: 47ch; /* the prose column: 58 rendered characters */
35
- --wide: min(100%, 64ch); /* what a table, a figure and a code block may take */
36
- --body-size: 16.5px;
37
- --body-lead: 1.62;
38
- --h1-size: clamp(34px, 4.4vw, 52px);
39
- --h2-size: clamp(25px, 2.5vw, 32px);
40
- --h3-size: 19px;
41
- /* the ledger declares no surfaces: every one of these is the page ground */
42
- --art-bg: transparent;
43
- --art-edge: transparent;
44
- --art-pad: 0px;
45
- --art-radius: 0px;
46
- --toc-bg: transparent;
47
- --toc-edge: transparent;
48
- --toc-pad: 0px;
49
- --fig-bg: transparent;
50
- --fig-edge: transparent;
51
- --fig-pad: var(--sp-md) 0;
52
- --code-bg: transparent;
53
- --code-edge: transparent;
54
- --sidebar-bg: var(--bg);
55
- --topbar-bg: var(--bg);
56
-
57
- margin: 0;
58
- min-height: 100dvh;
59
- display: grid;
60
- grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
61
- grid-template-rows: auto minmax(0, 1fr);
62
- background: var(--bg);
63
- color: var(--ink);
64
- font-family: var(--font-body);
65
- font-size: var(--body-size);
66
- line-height: var(--body-lead);
67
- -webkit-font-smoothing: antialiased;
68
- }
69
-
70
- /* ---------- shared atoms ---------- */
71
-
72
- .u-sr {
73
- position: absolute; width: 1px; height: 1px; margin: -1px;
74
- padding: 0; overflow: hidden; clip-path: inset(50%); white-space: nowrap;
75
- }
76
- .num { font-variant-numeric: tabular-nums; }
77
- .label {
78
- font: 400 var(--label-size)/1.25 var(--label-face);
79
- letter-spacing: var(--label-space);
80
- text-transform: var(--label-case);
81
- color: var(--ink-faint);
82
- }
83
- .nav-icon, .topbar-icon, .foot-icon {
84
- width: 16px; height: 16px; flex: none;
85
- fill: none; stroke: currentColor; stroke-width: 1.4;
86
- stroke-linecap: round; stroke-linejoin: round;
87
- }
88
-
89
- .skip {
90
- position: absolute; left: var(--sp-sm); top: -60px; z-index: 200;
91
- display: inline-flex; align-items: center; min-height: 34px;
92
- padding: 6px 18px; border-radius: var(--radius-pill);
93
- background: var(--bg-card); color: var(--ink);
94
- border: var(--line) solid var(--rule); text-decoration: none; font-size: 14px;
95
- transition: top 200ms cubic-bezier(.2, .7, .3, 1);
96
- }
97
- .skip:focus { top: var(--sp-xs); }
98
-
99
- /* ---------- the focus treatment ----------
100
- the world's two-tone ring: a 2px accent-derived outline at 3px offset inside
101
- an 8px page-ground halo. ?state=focus paints it on four real controls through
102
- .is-focus, so a reviewer sees the ring without anything calling .focus(). */
103
-
104
- :focus-visible,
105
- body[data-state="focus"] .is-focus {
106
- outline: 2px solid var(--focus);
107
- outline-offset: 3px;
108
- box-shadow: 0 0 0 8px var(--bg);
109
- border-radius: 3px;
110
- }
111
-
112
- /* ---------- the sidebar ---------- */
113
-
114
- .app-sidebar {
115
- grid-column: 1; grid-row: 1 / 3;
116
- position: sticky; top: 0; height: 100dvh;
117
- display: flex; flex-direction: column; min-height: 0;
118
- overflow: hidden; /* the sidebar never scrolls: its nav does */
119
- background: var(--sidebar-bg);
120
- border-right: var(--line) solid var(--rule);
121
- z-index: var(--z-sidebar);
122
- }
123
- .app-sidebar__brand {
124
- flex: none; height: var(--topbar-h);
125
- display: flex; align-items: center;
126
- padding: 0 var(--shell-pad);
127
- border-bottom: var(--line) solid var(--rule);
128
- }
129
- .brand-mark {
130
- flex: 1 1 auto; min-width: 24px;
131
- display: flex; align-items: center; gap: 10px;
132
- min-height: 30px; padding: 3px 0;
133
- color: var(--ink); text-decoration: none;
134
- font-weight: 500; font-size: 15.5px; letter-spacing: -.015em;
135
- }
136
- .brand-mark__dot {
137
- width: 11px; height: 11px; flex: none;
138
- border: 2px solid var(--ink); border-radius: var(--radius-pill);
139
- }
140
- .brand-mark__name { white-space: nowrap; }
141
-
142
- .app-sidebar__nav {
143
- flex: 1 1 auto; min-height: 0; overflow-y: auto;
144
- padding: var(--sp-sm) 0 var(--sp-md);
145
- }
146
- .nav-group { padding: 0 var(--shell-pad) var(--sp-sm); }
147
- .nav-group + .nav-group {
148
- margin-top: var(--sp-sm);
149
- border-top: var(--line) solid var(--rule-soft);
150
- padding-top: var(--sp-sm);
151
- }
152
- .nav-group__head {
153
- display: flex; align-items: center; justify-content: space-between;
154
- width: 100%; min-height: 28px; padding: 4px 0 8px; margin: 0;
155
- background: none; border: 0; cursor: pointer;
156
- font: 400 var(--label-size)/1.25 var(--label-face);
157
- letter-spacing: var(--label-space); text-transform: var(--label-case);
158
- color: var(--ink-faint);
159
- }
160
- .nav-group__chevron {
161
- width: 10px; height: 6px; flex: none;
162
- fill: none; stroke: currentColor; stroke-width: 1.4;
163
- stroke-linecap: round; stroke-linejoin: round;
164
- }
165
- .nav-item {
166
- text-transform: lowercase;
167
- display: flex; align-items: center; gap: 11px;
168
- min-height: 34px; padding: 5px 0 5px 11px; margin-left: -11px;
169
- border-left: 2px solid transparent;
170
- color: var(--ink-soft); text-decoration: none; font-size: 14.5px;
171
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
172
- }
173
- .nav-item:hover { color: var(--ink); }
174
- .nav-item__label { white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
175
- /* the lifecycle rail's lit-step grammar: the current page takes a 2px accent
176
- hairline on its LEFT edge. The only accent in the sidebar. */
177
- .nav-item--active { color: var(--ink); border-left-color: var(--accent); }
178
-
179
- .app-sidebar__foot {
180
- flex: none; display: flex; align-items: center; gap: 6px;
181
- padding: var(--sp-sm) 14px;
182
- border-top: var(--line) solid var(--rule);
183
- }
184
- .shell-user {
185
- flex: 1 1 auto; min-width: 0;
186
- display: flex; align-items: center; gap: 10px;
187
- min-height: 40px; padding: 2px 0;
188
- color: var(--ink); text-decoration: none;
189
- }
190
- .shell-user__avatar {
191
- width: 28px; height: 28px; flex: none; border-radius: var(--radius-pill);
192
- background: color-mix(in srgb, var(--ink) 13%, var(--bg));
193
- border: var(--line) solid var(--rule);
194
- }
195
- .shell-user__meta { display: flex; flex-direction: column; min-width: 0; }
196
- .shell-user__name {
197
- font-size: 13.5px; font-weight: 500;
198
- white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
199
- }
200
- .shell-user__rank {
201
- font: 400 var(--label-size)/1.35 var(--label-face);
202
- letter-spacing: var(--label-space); text-transform: var(--label-case);
203
- color: var(--ink-faint);
204
- }
205
- .shell-home, .shell-signout {
206
- flex: none; width: 30px; height: 30px;
207
- display: inline-flex; align-items: center; justify-content: center;
208
- color: var(--ink-faint); text-decoration: none;
209
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
210
- }
211
- .shell-home:hover, .shell-signout:hover { color: var(--ink); }
212
-
213
- .app-scrim { display: none; }
214
-
215
- /* ---------- the topbar ---------- */
216
-
217
- .app-topbar {
218
- grid-column: 2; grid-row: 1;
219
- position: sticky; top: 0; z-index: var(--z-topbar);
220
- height: var(--topbar-h);
221
- display: flex; align-items: center; gap: var(--sp-sm);
222
- padding: 0 var(--gutter);
223
- background: var(--topbar-bg);
224
- border-bottom: var(--line) solid var(--rule);
225
- }
226
- .topbar-menu {
227
- display: none; width: 32px; height: 32px; margin-left: -6px;
228
- align-items: center; justify-content: center;
229
- background: none; border: 0; color: var(--ink-soft); cursor: pointer;
230
- }
231
- .topbar-title {
232
- margin: 0;
233
- font-family: var(--font-display); font-weight: 300;
234
- font-size: 20px; letter-spacing: -.03em; color: var(--ink);
235
- }
236
- .topbar-side { margin-left: auto; display: flex; align-items: center; gap: var(--sp-xs); }
237
- .topbar-note {
238
- font: 400 var(--label-size)/1.25 var(--label-face);
239
- letter-spacing: var(--label-space); text-transform: var(--label-case);
240
- color: var(--ink-faint); white-space: nowrap;
241
- }
242
- .topbar-jump {
243
- display: inline-flex; align-items: center; gap: 9px;
244
- min-height: 30px; padding: 0 12px;
245
- background: none; border: var(--line) solid var(--rule);
246
- border-radius: var(--radius-pill);
247
- color: var(--ink-soft); font-family: var(--font-body); font-size: 13px;
248
- cursor: pointer;
249
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
250
- }
251
- .topbar-jump:hover { color: var(--ink); }
252
- .topbar-jump__kbd { font: 400 11px var(--font-mono); color: var(--ink-faint); }
253
- .zoom-toggle, .theme-toggle {
254
- width: 30px; height: 30px;
255
- display: inline-flex; align-items: center; justify-content: center;
256
- background: none; border: 0; color: var(--ink-soft); cursor: pointer;
257
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
258
- }
259
- .zoom-toggle:hover, .theme-toggle:hover { color: var(--ink); }
260
-
261
- /* ---------- the content column ---------- */
262
-
263
- .app-content {
264
- grid-column: 2; grid-row: 2;
265
- min-width: 0; padding: 0 var(--gutter) var(--sp-xl);
266
- }
267
- .app-content:focus { outline: none; }
268
-
269
- /* ---------- 1. the reading progress bar ----------
270
- pinned at the top of the content, under the topbar, above the article. It is
271
- the content column's progress, not app chrome, so it stops at the sidebar. */
272
-
273
- .primer-progress {
274
- position: sticky; top: var(--topbar-h); z-index: 25;
275
- height: 3px; margin: 0 calc(var(--gutter) * -1);
276
- background: color-mix(in srgb, var(--accent) 14%, transparent);
277
- }
278
- .primer-progress__bar {
279
- height: 100%; width: 46%;
280
- background: var(--accent);
281
- transition: width 200ms cubic-bezier(.2, .7, .3, 1);
282
- }
283
- body[data-state="loading"] .primer-progress__bar,
284
- body[data-state="empty"] .primer-progress__bar,
285
- body[data-state="error"] .primer-progress__bar { width: 0; }
286
-
287
- /* ---------- the page head ---------- */
288
-
289
- .page-head {
290
- padding: var(--sp-lg) 0 var(--sp-md);
291
- border-bottom: var(--line) solid var(--rule);
292
- margin-bottom: var(--sp-lg);
293
- }
294
- .page-head__eyebrow { margin: 0 0 12px; }
295
- .page-head__h {
296
- margin: 0;
297
- font-family: var(--font-display); font-weight: 300;
298
- font-size: var(--h1-size); line-height: 1.02; letter-spacing: -.042em;
299
- text-transform: lowercase; color: var(--ink);
300
- }
301
- .page-head__sub {
302
- margin: var(--sp-sm) 0 0; max-width: var(--measure);
303
- color: var(--ink-soft); font-size: 15.5px;
304
- }
305
-
306
- /* ---------- 2. the sticky table of contents ---------- */
307
-
308
- .primer-layout {
309
- display: grid;
310
- grid-template-columns: var(--toc-w) minmax(0, 1fr);
311
- gap: var(--col-gap);
312
- align-items: start;
313
- }
314
- .primer-toc {
315
- position: sticky; top: calc(var(--topbar-h) + var(--sp-md));
316
- align-self: start;
317
- }
318
- .primer-toc__toggle {
319
- display: none; width: 100%;
320
- align-items: center; justify-content: space-between;
321
- min-height: 42px; padding: 8px 14px;
322
- background: none; border: var(--line) solid var(--rule);
323
- border-radius: var(--radius-sm);
324
- color: var(--ink); font-family: var(--font-body); font-size: 14px;
325
- cursor: pointer;
326
- }
327
- .primer-toc__chevron {
328
- width: 10px; height: 6px; flex: none;
329
- fill: none; stroke: currentColor; stroke-width: 1.4;
330
- stroke-linecap: round; stroke-linejoin: round;
331
- transition: transform 200ms cubic-bezier(.2, .7, .3, 1);
332
- }
333
- .primer-toc__toggle[aria-expanded="true"] .primer-toc__chevron { transform: rotate(180deg); }
334
- .primer-toc__inner {
335
- background: var(--toc-bg);
336
- border: var(--line) solid var(--toc-edge);
337
- padding: var(--toc-pad);
338
- }
339
- .primer-toc__heading { margin: 0 0 var(--sp-xs); }
340
- .primer-toc__list { list-style: none; margin: 0; padding: 0; counter-reset: toc; }
341
- .primer-toc__list li { border-top: var(--line) solid var(--rule-soft); }
342
- .primer-toc__list a {
343
- display: flex; align-items: baseline; gap: 10px;
344
- min-height: 30px; padding: 8px 0 8px 10px; margin-left: -10px;
345
- border-left: 2px solid transparent;
346
- color: var(--ink-soft); text-decoration: none;
347
- font-size: 14px; line-height: 1.35;
348
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
349
- }
350
- .primer-toc__list a::before {
351
- counter-increment: toc;
352
- content: counter(toc, decimal-leading-zero);
353
- flex: none;
354
- font: 400 11px/1 var(--font-mono); font-variant-numeric: tabular-nums;
355
- color: var(--ink-faint);
356
- }
357
- .primer-toc__list a:hover { color: var(--ink); }
358
- /* the scrollspy's lit row: the section being read. Same grammar as the nav. */
359
- .primer-toc__list a.is-active { color: var(--ink); border-left-color: var(--accent); }
360
- .primer-toc__placeholder {
361
- padding: 10px 0; color: var(--ink-faint); font-size: 14px;
362
- border-top: var(--line) solid var(--rule-soft);
363
- }
364
-
365
- /* ---------- 3. the article ---------- */
366
-
367
- .primer-article {
368
- max-width: var(--wide);
369
- padding: var(--art-pad);
370
- background: var(--art-bg);
371
- border: var(--line) solid var(--art-edge);
372
- border-radius: var(--art-radius);
373
- counter-reset: sec;
374
- color: var(--ink);
375
- }
376
- /* prose is measured; a table, a figure and a code block may run wider */
377
- .primer-article > p,
378
- .primer-article > ul,
379
- .primer-article > ol,
380
- .primer-article > blockquote,
381
- .primer-article > h3 { max-width: var(--measure); }
382
-
383
- .primer-article h2 {
384
- margin: var(--sp-xl) 0 var(--sp-sm);
385
- padding-top: var(--sp-md);
386
- border-top: var(--line) solid var(--rule);
387
- scroll-margin-top: calc(var(--topbar-h) + 28px);
388
- font-family: var(--font-display); font-weight: 300;
389
- font-size: var(--h2-size); line-height: 1.08; letter-spacing: -.035em;
390
- color: var(--ink);
391
- }
392
- /* the mono section number over the hairline: the ledger's column head */
393
- .primer-article h2::before {
394
- counter-increment: sec;
395
- content: counter(sec, decimal-leading-zero);
396
- display: block; margin-bottom: 12px;
397
- font: 400 var(--label-size)/1.25 var(--label-face);
398
- letter-spacing: var(--label-space); font-variant-numeric: tabular-nums;
399
- color: var(--ink-faint);
400
- }
401
- .primer-article > h2:first-child { margin-top: 0; border-top: 0; padding-top: 0; }
402
- .primer-article h3 {
403
- margin: var(--sp-lg) 0 var(--sp-xs);
404
- font-family: var(--font-display); font-weight: 400;
405
- font-size: var(--h3-size); letter-spacing: -.02em; color: var(--ink);
406
- }
407
- .primer-article p { margin: 0 0 var(--sp-sm); }
408
- .primer-article ul, .primer-article ol { margin: 0 0 var(--sp-md); padding-left: 1.4em; }
409
- .primer-article li { margin-bottom: 9px; }
410
- .primer-article li::marker { color: var(--ink-faint); }
411
- .primer-article a {
412
- color: var(--accent-ink);
413
- /* 1px of vertical padding takes the inline hit area past the 24px floor */
414
- padding: 1px 0;
415
- text-decoration: underline; text-underline-offset: 3px; text-decoration-thickness: 1px;
416
- }
417
- .primer-article strong { font-weight: 600; color: var(--ink); }
418
- .primer-article em { font-style: italic; }
419
- .primer-article code {
420
- font: 400 .87em/1.4 var(--font-mono);
421
- background: color-mix(in srgb, var(--ink) 7%, transparent);
422
- padding: 1px 5px; border-radius: 3px;
423
- }
424
- .primer-article pre {
425
- margin: 0 0 var(--sp-md); max-width: var(--wide);
426
- padding: var(--sp-sm) 0 var(--sp-sm) var(--sp-md);
427
- overflow-x: auto;
428
- background: var(--code-bg);
429
- border: var(--line) solid var(--code-edge);
430
- border-left: 2px solid var(--rule);
431
- }
432
- .primer-article pre code {
433
- background: none; padding: 0; border-radius: 0;
434
- font-size: 13.5px; line-height: 1.72; color: var(--ink-soft);
435
- }
436
- .primer-article blockquote {
437
- margin: var(--sp-md) 0; padding-left: var(--sp-md);
438
- border-left: 2px solid var(--rule);
439
- color: var(--ink-soft);
440
- }
441
- .primer-article blockquote p { margin: 0; }
442
- .primer-article table {
443
- width: 100%; max-width: var(--wide);
444
- border-collapse: collapse; margin: 0 0 var(--sp-md);
445
- font-size: 14.5px; font-variant-numeric: tabular-nums;
446
- }
447
- .primer-article th, .primer-article td {
448
- text-align: left; vertical-align: top;
449
- padding: 10px 14px 10px 0;
450
- border-bottom: var(--line) solid var(--rule-soft);
451
- }
452
- .primer-article th {
453
- font: 400 var(--label-size)/1.25 var(--label-face);
454
- letter-spacing: var(--label-space); text-transform: var(--label-case);
455
- color: var(--ink-faint);
456
- border-bottom: var(--line) solid var(--rule);
457
- padding-bottom: 11px;
458
- }
459
- .primer-article td.t-id { font: 400 13px var(--font-mono); color: var(--ink-faint); }
460
- .primer-article td.t-n, .primer-article th.t-n { text-align: right; padding-right: 0; }
461
- .primer-article tr:last-child td { border-bottom: 0; }
462
-
463
- /* ---------- 4. the inline diagram ---------- */
464
-
465
- .primer-figure { margin: var(--sp-lg) 0; max-width: var(--wide); }
466
- .primer-figure__frame {
467
- position: relative;
468
- padding: var(--fig-pad);
469
- background: var(--fig-bg);
470
- border: 0; border-top: var(--line) solid var(--rule);
471
- border-bottom: var(--line) solid var(--rule);
472
- }
473
- .primer-figure__art { display: block; width: 100%; height: auto; }
474
- .primer-figure__zoom {
475
- position: absolute; top: 10px; right: 0;
476
- display: inline-flex; align-items: center; gap: 8px;
477
- min-height: 30px; padding: 0 13px;
478
- background: var(--bg); border: var(--line) solid var(--rule);
479
- border-radius: var(--radius-pill);
480
- color: var(--ink-soft); font-family: var(--font-body); font-size: 12.5px;
481
- cursor: pointer;
482
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
483
- }
484
- .primer-figure__zoom:hover { color: var(--ink); }
485
- .primer-figure figcaption {
486
- margin-top: 12px; max-width: var(--measure);
487
- font-size: 13px; line-height: 1.5; color: var(--ink-faint);
488
- }
489
- .dgm-rule { stroke: var(--rule); stroke-width: 1; }
490
- .dgm-dot { fill: none; stroke: var(--ink-faint); stroke-width: 1.4; }
491
- .dgm-dot--lit { fill: var(--accent); stroke: var(--accent); }
492
- .dgm-step {
493
- font: 400 11px var(--label-face); letter-spacing: var(--label-space);
494
- fill: var(--ink-faint);
495
- }
496
- .dgm-step--lit { fill: var(--ink); }
497
- .dgm-clause { font: 400 11.5px var(--font-body); fill: var(--ink-faint); }
498
-
499
- /* ---------- the loading skeleton, in the shape of the article ---------- */
500
-
501
- .sk {
502
- display: block; height: 10px; border-radius: 2px;
503
- background: color-mix(in srgb, var(--ink) 9%, transparent);
504
- }
505
- .primer-toc__list--sk li { padding: 11px 0; border-top: var(--line) solid var(--rule-soft); }
506
- .primer-skeleton { max-width: var(--wide); }
507
- .primer-skeleton__h { height: 26px; width: 62%; margin-bottom: var(--sp-md); }
508
- .primer-skeleton__p { margin-bottom: var(--sp-md); max-width: var(--measure); }
509
- .primer-skeleton__p .sk { margin-bottom: 12px; }
510
- .primer-skeleton__rule { height: var(--line); margin: var(--sp-lg) 0 var(--sp-md); background: var(--rule); }
511
- .sk-w1 { width: 100%; } .sk-w2 { width: 96%; } .sk-w3 { width: 99%; }
512
- .sk-w4 { width: 91%; } .sk-w5 { width: 74%; } .sk-w6 { width: 46%; }
513
- .sk-w7 { width: 84%; } .sk-w8 { width: 63%; }
514
-
515
- /* ---------- the empty and error notes ---------- */
516
-
517
- .primer-note {
518
- max-width: var(--measure);
519
- padding-top: var(--sp-md);
520
- border-top: var(--line) solid var(--rule);
521
- }
522
- .primer-note__label { margin: 0 0 12px; }
523
- .primer-note--error .primer-note__label { color: var(--danger); }
524
- .primer-note__body { margin: 0 0 var(--sp-md); color: var(--ink-soft); }
525
- .primer-note__acts { display: flex; flex-wrap: wrap; gap: var(--sp-xs); margin: 0; }
526
- .primer-note__act {
527
- display: inline-flex; align-items: center; min-height: 34px; padding: 0 16px;
528
- border: var(--line) solid var(--rule); border-radius: var(--radius-pill);
529
- background: none; color: var(--ink); text-decoration: none;
530
- font-family: var(--font-body); font-size: 14px; cursor: pointer;
531
- }
532
- .primer-note__act:hover { border-color: var(--ink-faint); }
533
-
534
- /* ---------- 5. the acknowledge gate ---------- */
535
-
536
- .primer-ack {
537
- max-width: var(--wide);
538
- margin-top: var(--sp-xl);
539
- padding-top: var(--sp-md);
540
- border-top: var(--line) solid var(--rule);
541
- }
542
- .primer-ack__h {
543
- margin: 0 0 12px;
544
- font-family: var(--font-display); font-weight: 300;
545
- font-size: 26px; letter-spacing: -.03em; color: var(--ink);
546
- }
547
- .primer-ack__lede { margin: 0 0 var(--sp-sm); max-width: var(--measure); color: var(--ink-soft); }
548
- .primer-ack__meter { margin: 0 0 var(--sp-md); }
549
- .primer-ack__meter .num { color: var(--ink); }
550
- .primer-ack__btn {
551
- display: inline-flex; align-items: center;
552
- min-height: 44px; padding: 0 26px;
553
- background: none; border: var(--line) solid var(--rule);
554
- border-radius: var(--radius-pill);
555
- color: var(--ink-faint); font-family: var(--font-body); font-size: 15px;
556
- cursor: not-allowed;
557
- transition: color 200ms cubic-bezier(.2, .7, .3, 1);
558
- }
559
- /* the accent arrives only when the control becomes pressable: the One Warm
560
- Thing Rule made literal on a soft gate. */
561
- .primer-ack__btn[aria-disabled="false"] {
562
- background: var(--accent); border-color: var(--accent);
563
- color: var(--accent-on); cursor: pointer;
564
- }
565
- .primer-ack__note { margin: var(--sp-xs) 0 0; font-size: 13.5px; color: var(--ink-faint); }
566
-
567
- /* ---------- the state contract: real markup, shown and hidden by CSS ---------- */
568
-
569
- .p-populated, .p-loading, .p-empty, .p-error { display: none; }
570
- body[data-state="populated"] .p-populated,
571
- body[data-state="rail"] .p-populated,
572
- body[data-state="drawer"] .p-populated,
573
- body[data-state="focus"] .p-populated { display: block; }
574
- body[data-state="loading"] .p-loading { display: block; }
575
- body[data-state="empty"] .p-empty { display: block; }
576
- body[data-state="error"] .p-error { display: block; }
577
-
578
- /* ?state=focus also reveals the Sections disclosure so its ring is visible at
579
- 1440, where the disclosure is otherwise a narrow-width control. */
580
- body[data-state="focus"] .primer-toc__toggle { display: flex; margin-bottom: var(--sp-sm); }
581
-
582
- /* ---------- the rail: the sidebar collapsed to 64px ---------- */
583
-
584
- body[data-state="rail"] { --sidebar-w: var(--sidebar-w-rail); }
585
- body[data-state="rail"] .brand-mark__name,
586
- body[data-state="rail"] .nav-item__label,
587
- body[data-state="rail"] .nav-group__head-label,
588
- body[data-state="rail"] .nav-group__chevron,
589
- body[data-state="rail"] .shell-user__meta { display: none; }
590
- body[data-state="rail"] .app-sidebar__brand,
591
- body[data-state="rail"] .nav-group { padding-inline: 0; }
592
- body[data-state="rail"] .brand-mark,
593
- body[data-state="rail"] .nav-item,
594
- body[data-state="rail"] .nav-group__head,
595
- body[data-state="rail"] .shell-user { justify-content: center; margin-left: 0; padding-left: 0; }
596
- body[data-state="rail"] .nav-item { border-left: 0; border-right: 2px solid transparent; }
597
- body[data-state="rail"] .nav-item--active { border-right-color: var(--accent); }
598
- body[data-state="rail"] .nav-group__head { padding-bottom: 4px; }
599
- body[data-state="rail"] .app-sidebar__foot { flex-direction: column; gap: 6px; padding-inline: 0; }
600
-
601
- @media (max-width: 1024px) {
602
- .brand-mark__name, .nav-item__label, .nav-group__head-label,
603
- .nav-group__chevron, .shell-user__meta { display: none; }
604
- .app-sidebar__brand, .nav-group { padding-inline: 0; }
605
- .brand-mark, .nav-item, .nav-group__head, .shell-user {
606
- justify-content: center; margin-left: 0; padding-left: 0;
607
- }
608
- .nav-item { border-left: 0; border-right: 2px solid transparent; }
609
- .nav-item--active { border-right-color: var(--accent); }
610
- .nav-group__head { padding-bottom: 4px; }
611
- .app-sidebar__foot { flex-direction: column; gap: 6px; padding-inline: 0; }
612
- .topbar-note { display: none; }
613
- }
614
-
615
- /* ---------- the drawer ---------- */
616
-
617
- body[data-state="drawer"] { grid-template-columns: minmax(0, 1fr); }
618
- body[data-state="drawer"] .app-topbar,
619
- body[data-state="drawer"] .app-content { grid-column: 1; }
620
- body[data-state="drawer"] .topbar-menu { display: inline-flex; }
621
- body[data-state="drawer"] .app-sidebar {
622
- position: fixed; inset: 0 auto 0 0; width: 264px; height: 100dvh;
623
- transform: none; /* beats the narrow-width off-canvas rule */
624
- z-index: var(--z-drawer);
625
- border-right: var(--line) solid var(--rule);
626
- }
627
- body[data-state="drawer"] .brand-mark__name,
628
- body[data-state="drawer"] .nav-item__label,
629
- body[data-state="drawer"] .nav-group__head-label,
630
- body[data-state="drawer"] .nav-group__chevron,
631
- body[data-state="drawer"] .shell-user__meta { display: block; }
632
- body[data-state="drawer"] .app-sidebar__brand,
633
- body[data-state="drawer"] .nav-group { padding-inline: var(--shell-pad); }
634
- body[data-state="drawer"] .brand-mark,
635
- body[data-state="drawer"] .shell-user { justify-content: flex-start; }
636
- body[data-state="drawer"] .nav-group__head { justify-content: space-between; }
637
- body[data-state="drawer"] .nav-item {
638
- justify-content: flex-start; margin-left: -11px; padding-left: 11px;
639
- border-right: 0; border-left: 2px solid transparent;
640
- }
641
- body[data-state="drawer"] .nav-item--active { border-left-color: var(--accent); }
642
- body[data-state="drawer"] .app-sidebar__foot {
643
- flex-direction: row; gap: 6px; padding-inline: 14px;
644
- }
645
- body[data-state="drawer"] .app-scrim {
646
- display: block; position: fixed; inset: 0; z-index: var(--z-scrim);
647
- background: rgba(0, 0, 0, .55);
648
- }
649
-
650
- /* ---------- 760px: the page's one breakpoint ----------
651
- the same one primer.js's matchMedia mirrors and tests/hall_audit.mjs pins. */
652
-
653
- @media (max-width: 760px) {
654
- body {
655
- --gutter: 20px;
656
- --col-gap: 0px;
657
- --body-size: 16px;
658
- --measure: 100%;
659
- grid-template-columns: minmax(0, 1fr);
660
- }
661
- .app-topbar, .app-content { grid-column: 1; }
662
- .topbar-menu { display: inline-flex; }
663
- .app-sidebar {
664
- position: fixed; inset: 0 auto 0 0; width: 264px;
665
- transform: translateX(-100%); z-index: var(--z-drawer);
666
- }
667
- .primer-layout { grid-template-columns: minmax(0, 1fr); }
668
- .primer-toc { position: static; margin-bottom: var(--sp-md); }
669
- .primer-toc__toggle { display: flex; }
670
- .primer-toc__inner { display: none; margin-top: 8px; }
671
- .primer-toc__toggle[aria-expanded="true"] + .primer-toc__inner { display: block; }
672
- .primer-article h2 { font-size: 23px; }
673
- .page-head__h { font-size: 34px; }
674
- /* a markdown table's column count is fixed by its source, so its min-content
675
- width outruns a phone. Give the table its own scrollport rather than let it
676
- drag the page sideways. This is primer.css's shipped rule, unchanged. */
677
- .primer-article table {
678
- display: block; width: max-content; max-width: 100%; overflow-x: auto;
679
- }
680
- .primer-figure__zoom { position: static; margin-top: var(--sp-xs); }
681
- }
682
- </style>
683
- <script>
684
- (function(){try{var q=new URLSearchParams(location.search||location.hash.slice(1)||'').get('mode');
685
- var m=(q==='light'||q==='dark')?q:'dark';
686
- document.documentElement.setAttribute('data-mode',m);
687
- document.documentElement.setAttribute('data-theme',m);}catch(e){}})();
688
- </script>
689
- </head>
690
- <body class="mock" data-state="populated">
691
- <!--
692
- Reading room in the chrome world, v1 "the ledger" (task 1003302, goal 1000081).
693
- THESIS A long document does not need a container: it needs a ruled page, so the article sits
694
- straight on the ground and hairlines carry every division the eye has to see.
695
- COMPOSITION First viewport at 1440: hairline sidebar, 56px topbar, then a 3px progress hairline
696
- pinned under it, the lowercase h1 "the primer" over a full width rule, and below it a
697
- 232px bare hairline table of contents beside a 58ch prose column whose section rules
698
- run the full 76ch content width, so the measure reads as a column inside a ledger.
699
- LIGHT Nothing inverts: the same page on pale paper, where the hairlines darken to real rules
700
- and the accent, spent only on the progress fill, the lit section and the ack button
701
- once it unlocks, is the single warm mark on the sheet.
702
- RISK A reading surface with no container gives the reader no edge to rest against: at 27
703
- pages the sections start to read as one undifferentiated scroll, and a code block or a
704
- table, having no ground of its own, has to be found rather than seen.
705
- ?state=populated the page with real data
706
- ?state=loading skeletons in the SHAPE of the final content
707
- ?state=empty nothing to show yet
708
- ?state=error the feed failed
709
- ?state=rail the sidebar collapsed to its 64px rail
710
- ?state=drawer the mobile drawer open
711
- ?state=focus keyboard focus rings on the page's real controls
712
- -->
713
-
714
- <a class="skip" href="#main">Skip to content</a>
715
-
716
- <div class="app-sidebar" id="app-sidebar">
717
- <div class="app-sidebar__brand">
718
- <a class="brand-mark" href="/" id="brand-mark">
719
- <span class="brand-mark__dot"></span><span class="brand-mark__name">Cloud Bongos</span></a>
720
- </div>
721
- <nav class="app-sidebar__nav" aria-label="Primary">
722
- <div class="nav-group">
723
- <a class="nav-item" id="nav-home" href="/" data-gate="always">
724
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 7.2 8 2.5l5.5 4.7V13a.5.5 0 0 1-.5.5H3a.5.5 0 0 1-.5-.5z"/></svg>
725
- <span class="nav-item__label">Home</span></a>
726
- <a class="nav-item" id="nav-roadmap" href="/roadmap" data-gate="always">
727
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 4h11M2.5 8h7.5M2.5 12h4.5"/></svg>
728
- <span class="nav-item__label">Roadmap</span></a>
729
- <a class="nav-item" id="nav-goals" href="/goals" data-gate="always">
730
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8" r="5.5"/><circle cx="8" cy="8" r="1.6"/></svg>
731
- <span class="nav-item__label">Goals</span></a>
732
- <a class="nav-item" id="nav-work" href="/work" data-gate="always">
733
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 4.5h11v9h-11zM2.5 7.5h11M6 7.5v6"/></svg>
734
- <span class="nav-item__label">Tasks</span></a>
735
- <a class="nav-item" id="nav-ideas" href="/ideas" data-gate="always">
736
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 2.5a3.6 3.6 0 0 0-2.2 6.4v1.3h4.4V8.9A3.6 3.6 0 0 0 8 2.5zM6.4 12.6h3.2"/></svg>
737
- <span class="nav-item__label">Ideas</span></a>
738
- <a class="nav-item" id="nav-copy-desk" href="/copy-desk" data-gate="always">
739
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M4 2.5h5l3 3v8H4zM9 2.5v3h3"/></svg>
740
- <span class="nav-item__label">Copy desk</span></a>
741
- </div>
742
- <div class="nav-group nav-group--collapsible" id="nav-items-you" data-group="you">
743
- <button class="nav-group__head" data-gate="signed" data-group="you" aria-controls="nav-items-you" aria-expanded="true">
744
- <span class="nav-group__head-label">You</span>
745
- <svg class="nav-group__chevron" viewBox="0 0 10 6" aria-hidden="true"><path d="M1 1.2 5 4.8 9 1.2"/></svg></button>
746
- <a class="nav-item" id="nav-standing" href="/#standing" data-gate="signed">
747
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M3 13.5V9M8 13.5V4.5M13 13.5v-3"/></svg>
748
- <span class="nav-item__label">Standing</span></a>
749
- <a class="nav-item" id="nav-profile" href="/profile" data-gate="signed">
750
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="5.6" r="2.6"/><path d="M3.2 13.5a4.8 4.8 0 0 1 9.6 0"/></svg>
751
- <span class="nav-item__label">Profile</span></a>
752
- </div>
753
- <div class="nav-group nav-group--collapsible" id="nav-items-community" data-group="community">
754
- <button class="nav-group__head" data-gate="signed" data-group="community" aria-controls="nav-items-community" aria-expanded="true">
755
- <span class="nav-group__head-label">Community</span>
756
- <svg class="nav-group__chevron" viewBox="0 0 10 6" aria-hidden="true"><path d="M1 1.2 5 4.8 9 1.2"/></svg></button>
757
- <a class="nav-item" id="nav-collab" href="/collab" data-gate="signed">
758
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="5.6" cy="5.6" r="2.1"/><circle cx="10.6" cy="10.4" r="2.1"/><path d="M7.2 7.2 9 8.9"/></svg>
759
- <span class="nav-item__label">Collab</span></a>
760
- <a class="nav-item" id="nav-leaderboard" href="/#leaderboard" data-gate="signed">
761
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 13.5h11M5 13.5V8.2h2.2v5.3M8.8 13.5V4.5H11v9"/></svg>
762
- <span class="nav-item__label">Leaderboard</span></a>
763
- <a class="nav-item" id="nav-people" href="/people" data-gate="signed">
764
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="6" cy="5.6" r="2.2"/><path d="M2.2 13.2a3.9 3.9 0 0 1 7.6 0M10.6 4.1a2.2 2.2 0 0 1 0 4.3M11.6 9.7a3.9 3.9 0 0 1 2.2 3.5"/></svg>
765
- <span class="nav-item__label">People</span></a>
766
- </div>
767
- <div class="nav-group nav-group--collapsible" id="nav-items-docs" data-group="docs">
768
- <button class="nav-group__head" data-gate="always" data-group="docs" aria-controls="nav-items-docs" aria-expanded="true">
769
- <span class="nav-group__head-label">Docs</span>
770
- <svg class="nav-group__chevron" viewBox="0 0 10 6" aria-hidden="true"><path d="M1 1.2 5 4.8 9 1.2"/></svg></button>
771
- <a class="nav-item nav-item--active is-focus" id="nav-primer" href="/primer" data-gate="always" aria-current="page">
772
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 4.4v9M8 4.4A3.4 3.4 0 0 0 5 2.9H2.6v8.6H5a3.4 3.4 0 0 1 3 1.9M8 4.4A3.4 3.4 0 0 1 11 2.9h2.4v8.6H11a3.4 3.4 0 0 0-3 1.9"/></svg>
773
- <span class="nav-item__label">Primer</span></a>
774
- <a class="nav-item" id="nav-ranks" href="/ranks" data-gate="always">
775
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M3 11.5l5-4 5 4M3 7.5l5-4 5 4"/></svg>
776
- <span class="nav-item__label">Ranks</span></a>
777
- <a class="nav-item" id="nav-economy" href="/drachmae" data-gate="always">
778
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8" r="5.5"/><path d="M6 6.4h4M6 9.6h4M8 4.6v6.8"/></svg>
779
- <span class="nav-item__label">Economy</span></a>
780
- <a class="nav-item" id="nav-diagrams" href="/diagrams" data-gate="always">
781
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 2.8h4.2v3.4H2.5zM9.3 9.8h4.2v3.4H9.3zM4.6 6.2v3.6h6.8"/></svg>
782
- <span class="nav-item__label">Diagrams</span></a>
783
- <a class="nav-item" id="nav-atlas" href="/atlas" data-gate="always">
784
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 12.8V4.2h4l1.2 1.6h5.8v7z"/></svg>
785
- <span class="nav-item__label">Repo Atlas</span></a>
786
- <a class="nav-item" id="nav-modules" href="/modules" data-gate="always">
787
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.8 2.8h4.2v4.2H2.8zM9 2.8h4.2v4.2H9zM2.8 9h4.2v4.2H2.8zM9 9h4.2v4.2H9z"/></svg>
788
- <span class="nav-item__label">Modules</span></a>
789
- <a class="nav-item" id="nav-apidocs" href="/docs" data-gate="always">
790
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M6 3.6 2.6 8 6 12.4M10 3.6 13.4 8 10 12.4"/></svg>
791
- <span class="nav-item__label">API docs</span></a>
792
- </div>
793
- <div class="nav-group nav-group--collapsible" id="nav-items-government" data-group="government">
794
- <button class="nav-group__head" data-gate="signed" data-group="government" aria-controls="nav-items-government" aria-expanded="true">
795
- <span class="nav-group__head-label">Government</span>
796
- <svg class="nav-group__chevron" viewBox="0 0 10 6" aria-hidden="true"><path d="M1 1.2 5 4.8 9 1.2"/></svg></button>
797
- <a class="nav-item" id="nav-watch" href="/watch" data-gate="signed">
798
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M1.6 8s2.4-4.2 6.4-4.2S14.4 8 14.4 8s-2.4 4.2-6.4 4.2S1.6 8 1.6 8z"/><circle cx="8" cy="8" r="1.8"/></svg>
799
- <span class="nav-item__label">Watch</span></a>
800
- <a class="nav-item" id="nav-harbor" href="/harbor" data-gate="signed">
801
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="3.4" r="1.4"/><path d="M8 4.9v8.6M4.6 7.1h6.8M2.9 9.4a5.1 5.1 0 0 0 10.2 0"/></svg>
802
- <span class="nav-item__label">Harbor</span></a>
803
- <a class="nav-item" id="nav-gate" href="/gate" data-gate="signed">
804
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.8 13.5V6L8 2.8 13.2 6v7.5M6.2 13.5V9h3.6v4.5"/></svg>
805
- <span class="nav-item__label">Gate</span></a>
806
- <a class="nav-item" id="nav-sessions" href="/sessions" data-gate="signed">
807
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8" r="5.5"/><path d="M8 4.8V8l2.4 1.4"/></svg>
808
- <span class="nav-item__label">Sessions</span></a>
809
- <a class="nav-item" id="nav-government" href="/government" data-gate="signed">
810
- <svg class="nav-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 2.4l4.8 1.8v4c0 3-2.1 4.6-4.8 5.4-2.7-.8-4.8-2.4-4.8-5.4v-4z"/></svg>
811
- <span class="nav-item__label">Permissions</span></a>
812
- </div>
813
- </nav>
814
- <div class="app-sidebar__foot">
815
- <a class="shell-user" id="shell-user" href="/settings" title="Settings">
816
- <span class="shell-user__avatar"></span>
817
- <span class="shell-user__meta">
818
- <span class="shell-user__name">Percy Jackson</span>
819
- <span class="shell-user__rank">Owner</span></span></a>
820
- <a class="shell-home" href="/" title="Back to Cloud Bongos">
821
- <svg class="foot-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 7.2 8 2.5l5.5 4.7V13a.5.5 0 0 1-.5.5H3a.5.5 0 0 1-.5-.5z"/></svg>
822
- <span class="u-sr">Back to Cloud Bongos</span></a>
823
- <a class="shell-signout" href="/api/bongos/auth/logout" title="Sign out">
824
- <svg class="foot-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M6.4 2.8H3.2v10.4h3.2M9.4 5.4 12 8l-2.6 2.6M12 8H6.2"/></svg>
825
- <span class="u-sr">Sign out</span></a>
826
- </div>
827
- </div>
828
- <div class="app-scrim" id="app-scrim" aria-hidden="true"></div>
829
-
830
- <header class="app-topbar" id="app-topbar">
831
- <button class="topbar-menu" id="topbar-menu" aria-label="Open navigation" aria-expanded="false">
832
- <svg class="topbar-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M2.5 4.5h11M2.5 8h11M2.5 11.5h11"/></svg></button>
833
- <h2 class="topbar-title">Primer</h2>
834
- <div class="topbar-side">
835
- <span class="topbar-note">Docs, a ten minute read</span>
836
- <button class="topbar-jump" id="topbar-jump" aria-label="Jump to a page or record">
837
- <span class="topbar-jump__label">Jump to</span><kbd class="topbar-jump__kbd">Ctrl K</kbd></button>
838
- <button class="zoom-toggle" aria-label="Text size">
839
- <svg class="topbar-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M1.8 12.4 5 4.6l3.2 7.8M2.9 10.2h4.2M9.6 12.4 12 7l2.4 5.4M10.4 10.6h3.2"/></svg></button>
840
- <button class="theme-toggle" aria-label="Switch theme">
841
- <svg class="topbar-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M13.2 9.4A5.6 5.6 0 0 1 6.6 2.8a5.6 5.6 0 1 0 6.6 6.6z"/></svg></button>
842
- </div>
843
- </header>
844
-
845
- <main class="app-content" id="main" tabindex="-1">
846
-
847
- <!-- 1. the reading progress bar -->
848
- <div class="primer-progress" aria-hidden="true"><div class="primer-progress__bar"></div></div>
849
-
850
- <div class="page-head">
851
- <p class="page-head__eyebrow label">Docs</p>
852
- <h1 class="page-head__h">the primer</h1>
853
- <p class="page-head__sub">Everything a new builder needs before claiming a first task: what this
854
- platform is, how work moves from claim to credit, and what each rank opens.</p>
855
- </div>
856
-
857
- <div class="primer-layout">
858
-
859
- <!-- 2. the sticky table of contents. Under 760px it collapses behind the
860
- Sections disclosure, the page's one breakpoint. -->
861
- <aside class="primer-toc" id="primer-toc" aria-label="Sections in this primer">
862
- <button type="button" class="primer-toc__toggle is-focus" id="primer-toc-toggle"
863
- aria-expanded="false" aria-controls="primer-toc-list">
864
- <span class="primer-toc__toggle-label">Sections</span>
865
- <svg class="primer-toc__chevron" viewBox="0 0 10 6" aria-hidden="true"><path d="M1 1.2 5 4.8 9 1.2"/></svg></button>
866
- <nav class="primer-toc__inner">
867
- <p class="primer-toc__heading label" id="primer-toc-heading">In this primer</p>
868
- <ol class="primer-toc__list p-populated" id="primer-toc-list" aria-labelledby="primer-toc-heading">
869
- <li><a href="#s-what">What Cloud Bongos is</a></li>
870
- <li><a class="is-active is-focus" href="#s-lifecycle" aria-current="location">The claim to ship lifecycle</a></li>
871
- <li><a href="#s-board">Reading the board</a></li>
872
- <li><a href="#s-ranks">Ranks, and what each one opens</a></li>
873
- <li><a href="#s-credits">Credits, and what they are worth</a></li>
874
- <li><a href="#s-first">Your first task</a></li>
875
- </ol>
876
- <ol class="primer-toc__list primer-toc__list--sk p-loading" aria-hidden="true">
877
- <li><span class="sk sk-w2"></span></li>
878
- <li><span class="sk sk-w5"></span></li>
879
- <li><span class="sk sk-w7"></span></li>
880
- <li><span class="sk sk-w4"></span></li>
881
- <li><span class="sk sk-w8"></span></li>
882
- <li><span class="sk sk-w6"></span></li>
883
- </ol>
884
- <ul class="primer-toc__list p-empty">
885
- <li class="primer-toc__placeholder">No sections yet</li>
886
- </ul>
887
- <ul class="primer-toc__list p-error">
888
- <li class="primer-toc__placeholder">Sections unavailable</li>
889
- </ul>
890
- </nav>
891
- </aside>
892
-
893
- <div class="primer-col">
894
-
895
- <!-- 3. the article. Flat markdown output: h2, h3, p, ul, ol, table, pre,
896
- blockquote and inline marks, nothing a reader would have to wrap. -->
897
- <article class="primer-article p-populated" id="primer-article">
898
-
899
- <h2 id="s-what">What Cloud Bongos is</h2>
900
- <p>Cloud Bongos is an <strong>AI first build platform</strong>. A human owner sets the scope and
901
- the hard gates; agents claim the work and write the code. Everything that happens to this
902
- project becomes a row in one ledger: a task is created, claimed, built, graded, shipped and
903
- paid. If a change is not in the ledger, the ledger lies, so there is no tiny fix that skips it
904
- and no setup step that counts as free.</p>
905
- <p>Two versions are open as you read this. <strong>BONGOS-V1</strong>, the platform itself, has
906
- shipped <span class="num">1,176</span> of <span class="num">1,612</span> tasks against
907
- <span class="num">190</span> criteria, <span class="num">75</span> percent complete.
908
- <strong>CB-V1</strong>, the Customer-0 dogfood, has shipped <span class="num">58</span> of
909
- <span class="num">155</span>. You may claim from either, on whichever suits the time you have.</p>
910
-
911
- <h3>The five rooms you will use in week one</h3>
912
- <p>The hall is where the work is done. Five of its rooms carry almost everything:</p>
913
- <ul>
914
- <li>The <a href="/work">board</a>, where every ready task is listed with its credits and its estimate.</li>
915
- <li><a href="/goals">Goals</a>, which gather tasks into one module scoped piece of work with a done condition.</li>
916
- <li>Your <a href="/#standing">standing</a>: your rank, your credits, and everything you have shipped.</li>
917
- <li>The docs, this page among them, which are the only place the method is written down.</li>
918
- <li>The <a href="/watch">watch</a>, where a grade, a merge or a deploy that went wrong surfaces first.</li>
919
- </ul>
920
-
921
- <h2 id="s-lifecycle">The claim to ship lifecycle</h2>
922
- <p>Work moves through five beats, always in this order. The rail below is the same one the task
923
- page draws, and the beat you are on is the lit one.</p>
924
-
925
- <!-- 4. the inline diagram, injected after a named h2, with an affordance
926
- to open it fullscreen. -->
927
- <figure class="primer-figure" id="fig-lifecycle">
928
- <div class="primer-figure__frame">
929
- <svg class="primer-figure__art" viewBox="0 0 660 132" role="img"
930
- aria-label="The five beats of the lifecycle, left to right: claim, build, grade, ship, credit. Build is the lit step.">
931
- <path class="dgm-rule" d="M24 20h108M150 20h108M276 20h108M402 20h108M528 20h108"/>
932
- <circle class="dgm-dot" cx="30" cy="44" r="5"/>
933
- <circle class="dgm-dot dgm-dot--lit" cx="156" cy="44" r="5"/>
934
- <circle class="dgm-dot" cx="282" cy="44" r="5"/>
935
- <circle class="dgm-dot" cx="408" cy="44" r="5"/>
936
- <circle class="dgm-dot" cx="534" cy="44" r="5"/>
937
- <text class="dgm-step" x="24" y="74">CLAIM</text>
938
- <text class="dgm-step dgm-step--lit" x="150" y="74">BUILD</text>
939
- <text class="dgm-step" x="276" y="74">GRADE</text>
940
- <text class="dgm-step" x="402" y="74">SHIP</text>
941
- <text class="dgm-step" x="528" y="74">CREDIT</text>
942
- <text class="dgm-clause" x="24" y="98">lock the task<tspan x="24" dy="16">to your session</tspan></text>
943
- <text class="dgm-clause" x="150" y="98">write it in your<tspan x="150" dy="16">own worktree</tspan></text>
944
- <text class="dgm-clause" x="276" y="98">a panel reads<tspan x="276" dy="16">the real diff</tspan></text>
945
- <text class="dgm-clause" x="402" y="98">merged, then<tspan x="402" dy="16">deployed</tspan></text>
946
- <text class="dgm-clause" x="528" y="98">paid on land,<tspan x="528" dy="16">not on claim</tspan></text>
947
- </svg>
948
- <button type="button" class="primer-figure__zoom" aria-label="Open the lifecycle diagram fullscreen">
949
- <svg class="topbar-icon" viewBox="0 0 16 16" aria-hidden="true"><path d="M6 2.5H2.5V6M10 2.5h3.5V6M10 13.5h3.5V10M6 13.5H2.5V10"/></svg>
950
- <span>Fullscreen</span></button>
951
- </div>
952
- <figcaption>The claim to ship lifecycle. Exactly one step is lit at a time, and credits land
953
- at ship, never at claim.</figcaption>
954
- </figure>
955
-
956
- <ol>
957
- <li><strong>Claim.</strong> A claim locks one task to one session, so two builders can work the
958
- same version without colliding. A claim is refused if the task is already held, is not ready,
959
- or has a dependency that has not shipped.</li>
960
- <li><strong>Build.</strong> Work from a worktree of your own, never the main checkout. Write the
961
- code, the doc comment and the tests together: a change with no test is a change nobody can
962
- defend at grade.</li>
963
- <li><strong>Grade.</strong> A panel of reviewers reads the real committed diff, not your summary
964
- of it. A grade that fails is a description of what is missing, not a verdict on you.</li>
965
- <li><strong>Ship.</strong> The task moves to confirmed when the checks are green, then to shipped
966
- when the branch is merged and deployed. The server lands most merges on its own.</li>
967
- <li><strong>Credit.</strong> Credits are written when the work lands, which is why an abandoned
968
- branch pays nothing and a merged one pays in full.</li>
969
- </ol>
970
-
971
- <blockquote>
972
- <p>A task you have not claimed is a task another builder can claim out from under you. Claim
973
- first, then open the editor.</p>
974
- </blockquote>
975
-
976
- <h3>The three commands</h3>
977
- <p>All five beats run from three commands. Run them from your own worktree:
978
- <code>claim.js</code> refuses in the main checkout on purpose, because branching there strands
979
- the ship at <em>confirmed</em> and somebody has to go and rescue it.</p>
980
- <pre><code>node scripts/gds/claim.js 1002529
981
- # build on the task branch, commit as you go
982
- node scripts/gds/ship.js --summary "Provisioned instances now read config/branding.json"</code></pre>
983
- <p><em>If a claim is refused, read the reason before you retry it.</em> The three refusals mean
984
- three different things, and only one of them is worth waiting out.</p>
985
-
986
- <h2 id="s-board">Reading the board</h2>
987
- <p>The board lists what is ready right now. Every row carries the version it belongs to, the kind
988
- of work, the credits it pays and the estimate it was written with. Sort by nothing: read the
989
- five at the top, and take the one you can finish today.</p>
990
-
991
- <table>
992
- <thead>
993
- <tr>
994
- <th scope="col">Task</th>
995
- <th scope="col">Version</th>
996
- <th scope="col">Kind</th>
997
- <th scope="col" class="t-n">Credits</th>
998
- <th scope="col" class="t-n">Estimate</th>
999
- </tr>
1000
- </thead>
1001
- <tbody>
1002
- <tr><td class="t-id">1001479</td><td>BONGOS-V1</td><td>infra</td><td class="t-n">10</td><td class="t-n">20m</td></tr>
1003
- <tr><td class="t-id">1002529</td><td>BONGOS-V1</td><td>bug</td><td class="t-n">50</td><td class="t-n">60m</td></tr>
1004
- <tr><td class="t-id">1002572</td><td>BONGOS-V1</td><td>bug</td><td class="t-n">60</td><td class="t-n">60m</td></tr>
1005
- <tr><td class="t-id">1003226</td><td>BONGOS-V1</td><td>bug</td><td class="t-n">25</td><td class="t-n">45m</td></tr>
1006
- <tr><td class="t-id">1003366</td><td>CB-V1</td><td>infra</td><td class="t-n">60</td><td class="t-n">240m</td></tr>
1007
- </tbody>
1008
- </table>
1009
-
1010
- <p>Task <span class="num">1002529</span>, "Provisioned instances ignore config/branding.json", is
1011
- the honest first claim on that list: one wrong lookup, a test that proves it, and a fix small
1012
- enough to read in one sitting. Task <span class="num">1003366</span> is not, because it edits
1013
- the protected surfaces file, and that needs a rank you do not have yet.</p>
1014
-
1015
- <h2 id="s-ranks">Ranks, and what each one opens</h2>
1016
- <p>There are four ranks. Rank is held in the database and checked on every request, so no local
1017
- file, this page included, can grant you anything. What rises with rank is not privilege for its
1018
- own sake: it is how much of the pipeline you are trusted to change.</p>
1019
- <ul>
1020
- <li><strong>Newcomer.</strong> Read everything, claim sandboxed work, ship it. The permission
1021
- and pipeline surfaces are closed, and the tooling will say so rather than let you push.</li>
1022
- <li><strong>Contributor.</strong> The ordinary building rank: claim across both versions, open
1023
- goals, file blockers, write ADRs.</li>
1024
- <li><strong>Trusted.</strong> Adds the daily cadence work, the triage of ideas and blockers, and
1025
- planning sessions that set a version's scope.</li>
1026
- <li><strong>Owner.</strong> Sets scope and the hard gates. One human owner per instance, plus the
1027
- agents the owner has raised to it.</li>
1028
- </ul>
1029
- <p>Rising is not a request you file. It is what the ledger says about the work you have already
1030
- shipped, read at review.</p>
1031
-
1032
- <h2 id="s-credits">Credits, and what they are worth</h2>
1033
- <p>Credits are the platform's currency, and one credit is one dollar of value returned. The
1034
- instance has spent <span class="num">$49,708.47</span> to date, almost all of it on model
1035
- calls, and the work that spend bought is carried at <span class="num">71,040</span> credits.
1036
- That ratio is the whole argument for the method, so it is on the wall rather than in a report.</p>
1037
- <p>A shipped task pays what it was written to pay. Task <span class="num">1003322</span>, which
1038
- carved the front door into its own module, paid <span class="num">60</span> credits: estimated
1039
- at <span class="num">240</span> minutes, shipped in <span class="num">37</span>. The estimate
1040
- is not a target and beating it earns nothing extra, which is deliberate.</p>
1041
- <p>The standing board reads, at the time of writing: lars589 on
1042
- <span class="num">44,562</span> credits, Percy Jackson on <span class="num">14,441</span>,
1043
- IAMMASTERQUA on <span class="num">3,316</span>, scootermack on <span class="num">2,646</span>.
1044
- A credit figure is data, not a live thing, so it is set in ink and never in the accent.</p>
1045
-
1046
- <h2 id="s-first">Your first task</h2>
1047
- <p>Do these in order. The whole loop, claim to credit, should take one sitting.</p>
1048
- <ol>
1049
- <li>Acknowledge this primer at the foot of the page.</li>
1050
- <li>Open the <a href="/work">board</a> and read the five ready tasks end to end before choosing.</li>
1051
- <li>Claim one, in a worktree of its own.</li>
1052
- <li>Write the failing test first, then the change that passes it.</li>
1053
- <li>Ship with a summary a non engineer could read, because that summary is what gets broadcast.</li>
1054
- </ol>
1055
- <p>If something in here turned out to be wrong, that is a task too: file it, claim it, and fix the
1056
- page. The <a href="/ranks">rank ladder</a> and the <a href="/drachmae">economy</a> pages go
1057
- deeper on the two subjects this one only sketches.</p>
1058
- </article>
1059
-
1060
- <!-- the loading state: a skeleton in the SHAPE of the article -->
1061
- <div class="primer-skeleton p-loading" aria-hidden="true">
1062
- <span class="sk primer-skeleton__h sk-w5"></span>
1063
- <div class="primer-skeleton__p">
1064
- <span class="sk sk-w1"></span><span class="sk sk-w3"></span>
1065
- <span class="sk sk-w2"></span><span class="sk sk-w5"></span>
1066
- </div>
1067
- <div class="primer-skeleton__p">
1068
- <span class="sk sk-w2"></span><span class="sk sk-w1"></span>
1069
- <span class="sk sk-w4"></span><span class="sk sk-w6"></span>
1070
- </div>
1071
- <div class="primer-skeleton__rule"></div>
1072
- <span class="sk primer-skeleton__h sk-w8"></span>
1073
- <div class="primer-skeleton__p">
1074
- <span class="sk sk-w3"></span><span class="sk sk-w1"></span>
1075
- <span class="sk sk-w7"></span><span class="sk sk-w5"></span>
1076
- </div>
1077
- </div>
1078
-
1079
- <!-- the empty state: the document loaded, and has no sections -->
1080
- <div class="primer-note p-empty">
1081
- <p class="primer-note__label label">No sections yet</p>
1082
- <p class="primer-note__body">The primer document exists but carries no headings, so there is
1083
- nothing to build a table of contents from and nothing to acknowledge. An owner writes the first
1084
- section in <code>docs/onboarding/primer.md</code>; this page renders it on the next load.</p>
1085
- <p class="primer-note__acts"><a class="primer-note__act" href="/work">Go to the board</a></p>
1086
- </div>
1087
-
1088
- <!-- the error state: the markdown failed to load -->
1089
- <div class="primer-note primer-note--error p-error">
1090
- <p class="primer-note__label label">The primer did not load</p>
1091
- <p class="primer-note__body">The markdown behind this page could not be fetched: the request to
1092
- <code>/builders/docs/primer.md</code> returned 502. Nothing you did caused it, and nothing you
1093
- have already read is lost.</p>
1094
- <p class="primer-note__acts">
1095
- <button type="button" class="primer-note__act">Try again</button>
1096
- <a class="primer-note__act" href="/watch">See the watch</a></p>
1097
- </div>
1098
-
1099
- <!-- 5. the acknowledge gate -->
1100
- <section class="primer-ack p-populated" id="primer-ack" aria-labelledby="primer-ack-h">
1101
- <h2 class="primer-ack__h" id="primer-ack-h">Acknowledge the primer</h2>
1102
- <p class="primer-ack__lede">Read to the end and the button below unlocks. It is an honour system
1103
- signal rather than a test: it records that you have seen the rules you are about to work under.</p>
1104
- <p class="primer-ack__meter label">Read <span class="num">46%</span> of the 90% needed</p>
1105
- <button type="button" class="primer-ack__btn is-focus" id="primer-ack-btn"
1106
- aria-disabled="true" aria-describedby="primer-ack-note">I have read it</button>
1107
- <p class="primer-ack__note" id="primer-ack-note">Locked until you reach 90 percent. The control
1108
- stays reachable by keyboard so it can say why.</p>
1109
- </section>
1110
-
1111
- </div>
1112
- </div>
1113
- </main>
1114
-
1115
- <script>
1116
- /* the mock's state contract: read ?state= once and apply it. Nothing is built here, and no motion. */
1117
- (function () {
1118
- var ok = ['populated', 'loading', 'empty', 'error', 'rail', 'drawer', 'focus'];
1119
- var s = new URLSearchParams(location.search || location.hash.slice(1) || '').get('state') || 'populated';
1120
- if (ok.indexOf(s) === -1) s = 'populated';
1121
- document.body.setAttribute('data-state', s);
1122
- })();
1123
- </script>
1124
- </body>
1125
- </html>