push-guard.test.ts

apps/dashboard/test/push-guard.test.ts

1. /**
2. * `pnpm push` writes straight into the Worker's KV, which is what the team reads.
3. * There is no review step between a laptop and that page, so the checks that
4. * would normally be a person noticing have to live in code.
5. *
6. * The one that matters most: `pnpm dashboard --fixtures` writes the SAME
7. * filenames as a live run. A push straight after one would put sample orders on
8. * the production board under four confident "live" source pills, the exact
9. * failure `Snapshot.mode` was introduced to prevent, except now with an audience.
10. */
12. import { describe, expect, it } from 'vitest'
13. import { checkPush, type PushInputs } from '../src/push-guard.js'
15. const live = (over: Partial<PushInputs> = {}): PushInputs => ({
16. payloadMode: 'live',
17. payloadGeneratedAt: '2026-08-25T20:27:27.386Z',
18. htmlBytes: 105_707,
19. briefingsMode: 'live',
20. briefingsPayloadGeneratedAt: '2026-08-25T20:27:27.386Z',
21. briefingCount: 9,
22. ...over,
23. })
25. describe('fixtures never reach the deployed board', () => {
26. it('refuses a fixture payload', () => {
27. const v = checkPush(live({ payloadMode: 'fixtures' }))
28. expect(v.ok).toBe(false)
29. expect(v.refusals.join(' ')).toMatch(/FIXTURE/)
30. })
32. it('refuses fixture briefings even when the payload is live', () => {
33. // Possible in practice: a live sync, then brief.py run with --allow-fixtures
34. // against an older payload. The prose would name people as holding work they
35. // finished.
36. const v = checkPush(live({ briefingsMode: 'fixtures' }))
37. expect(v.ok).toBe(false)
38. })
40. it('refuses a mode it does not recognise rather than assuming it is real', () => {
41. for (const mode of ['demo', '', null, undefined, 'LIVE']) {
42. expect(checkPush(live({ payloadMode: mode })).ok, String(mode)).toBe(false)
43. }
44. })
46. it('allows a live push', () => {
47. const v = checkPush(live())
48. expect(v.ok).toBe(true)
49. expect(v.refusals).toEqual([])
50. })
51. })
53. describe('a broken render is not published', () => {
54. it('refuses a page far too small to be a dashboard', () => {
55. // A failed render still writes a file. 500 bytes is an error page, not a board.
56. expect(checkPush(live({ htmlBytes: 500 })).ok).toBe(false)
57. })
59. it('refuses a missing page', () => {
60. expect(checkPush(live({ htmlBytes: 0 })).ok).toBe(false)
61. })
63. it('accepts a real render', () => {
64. expect(checkPush(live({ htmlBytes: 105_707 })).ok).toBe(true)
65. })
67. it('refuses a payload with no timestamp, since nothing on it can be dated', () => {
68. expect(checkPush(live({ payloadGeneratedAt: null })).ok).toBe(false)
69. })
70. })
72. describe('things worth saying but not worth stopping for', () => {
73. it('warns when there are no briefings rather than refusing', () => {
74. // Numbers-only is a legitimate push; the page says the written briefing was
75. // not generated. But a silent one looks identical to a complete push.
76. const v = checkPush(live({ briefingCount: 0 }))
77. expect(v.ok).toBe(true)
78. expect(v.warnings.join(' ')).toMatch(/No written briefings/)
79. })
81. it('warns when the briefings describe a different sync than the page', () => {
82. const v = checkPush(live({ briefingsPayloadGeneratedAt: '2026-08-25T06:00:00.000Z' }))
83. expect(v.ok).toBe(true)
84. expect(v.warnings.join(' ')).toMatch(/EARLIER sync/)
85. })
87. it('does not warn when they are paired', () => {
88. expect(checkPush(live()).warnings.join(' ')).not.toMatch(/EARLIER sync/)
89. })
91. it('is silent on a clean, paired, complete push', () => {
92. expect(checkPush(live()).warnings).toEqual([])
93. })
94. })
96. describe('every refusal explains itself', () => {
97. it('names what to do, not just what is wrong', () => {
98. const v = checkPush(live({ payloadMode: 'fixtures', htmlBytes: 10 }))
99. expect(v.refusals.length).toBeGreaterThan(1)
100. // A refusal a reader cannot act on gets worked around rather than fixed.
101. for (const r of v.refusals) expect(r).toMatch(/`?pnpm|Run|Regenerate|Refusing/)
102. })
103. })