roster.ts

scripts/roster.ts

1. #!/usr/bin/env tsx
2. /**
3. * Print the Ninety user directory as paste-ready config. Read-only.
4. *
5. * pnpm roster # human-readable table + both config blocks
6. * pnpm roster -- --json # write roster.json to stdout, nothing else
7. *
8. * A script and not a one-liner, because Ninety is not consistent about its id
9. * field: `GET /todos/company` returns `id` while `GET /todos/{id}` returns
10. * `_id`. A one-liner that hard-codes either key breaks on the endpoint that uses the
11. * other, and the failure is a bare KeyError that says nothing useful. This
12. * checks every plausible key and tells you which one it found.
13. *
14. * What to do with the output; two things, both printed ready to paste:
15. *
16. * 1. `ninetyId` values for config/meridian-people.ts. Names are typed by humans in
17. * another system and drift ("Samuel Whitaker" for "Sam Whitaker"); ids do not.
18. * Every current person is pinned this way, which is why the display-name
19. * aliases are empty. Run this for a new hire, or when
20. * `pnpm company` reports someone matched by name rather than by id.
21. * 2. roster.json, which pins people so anyone with no open work still renders
22. * as "covered, nothing open" rather than vanishing.
23. *
24. * The directory is not the team. It holds former staff and outside
25. * collaborators. Anyone
26. * not on staff belongs in KNOWN_NON_ROSTER_NINETY, not in roster.json.
27. */
29. import { clientFromEnv } from '@meridian/ninety-client'
30. import { personFromNinety, KNOWN_NON_ROSTER_NINETY } from '../config/meridian-people.js'
31. import { errorMessage } from '@meridian/shared'
33. interface RawUser {
34. [k: string]: unknown
35. }
37. /** Ninety uses `_id` on some endpoints and `id` on others. Take whichever exists. */
38. function idOf(u: RawUser): string | null {
39. for (const key of ['_id', 'id', 'userId']) {
40. const v = u[key]
41. if (typeof v === 'string' && v.length) return v
42. }
43. return null
44. }
46. function nameOf(u: RawUser): string {
47. const s = (k: string) => (typeof u[k] === 'string' ? (u[k] as string).trim() : '')
48. const joined = [s('firstName'), s('lastName')].filter(Boolean).join(' ')
49. return joined || s('fullName') || s('name') || s('email') || '(unnamed)'
50. }
52. async function main(): Promise<void> {
53. const client = clientFromEnv(process.env)
54. const raw = await client.http.get<unknown>('/users')
56. // Bare array on some endpoints, enveloped on others. Accept both rather than
57. // guessing.
58. const list: RawUser[] = Array.isArray(raw)
59. ? (raw as RawUser[])
60. : ((raw as { data?: RawUser[]; items?: RawUser[] }).data ??
61. (raw as { items?: RawUser[] }).items ??
62. [])
64. if (!list.length) {
65. console.error('GET /users returned no users. Top-level keys:',
66. raw && typeof raw === 'object' ? Object.keys(raw as object).join(', ') : typeof raw)
67. process.exit(1)
68. }
70. const users = list.map((u) => {
71. const id = idOf(u)
72. const name = nameOf(u)
73. const known = KNOWN_NON_ROSTER_NINETY.some((n) => n.toLowerCase() === name.toLowerCase())
74. return { id, name, known, person: personFromNinety(id, name) }
75. })
77. if (process.argv.includes('--json')) {
78. console.log(JSON.stringify({
79. entries: users.filter((u) => u.person && u.id).map((u) => ({ id: u.id, name: u.person!.name })),
80. }, null, 2))
81. return
82. }
84. const idKey = ['_id', 'id', 'userId'].find((k) => typeof list[0]![k] === 'string') ?? '(none)'
85. console.log(`Ninety directory: ${users.length} users (id field: ${idKey})\n`)
86. console.log('NAME'.padEnd(24) + 'ID'.padEnd(28) + 'STATUS')
87. console.log('-'.repeat(76))
88. for (const u of users) {
89. const status = u.known
90. ? 'declared non-roster'
91. : u.person
92. ? `roster: ${u.person.name}`
93. : 'NOT ON ROSTER, decide'
94. console.log(u.name.padEnd(24) + (u.id ?? '(no id)').padEnd(28) + status)
95. }
97. const undecided = users.filter((u) => !u.person && !u.known)
98. if (undecided.length) {
99. console.log(`\n${undecided.length} user(s) are neither on the roster nor declared non-roster.`)
100. console.log('Their to-dos count in company totals but appear on no per-person view.')
101. console.log('Add them to MERIDIAN_PEOPLE, or to KNOWN_NON_ROSTER_NINETY if they are not staff.')
102. }
104. console.log('\n\n--- paste into config/meridian-people.ts, one per person ---\n')
105. for (const u of users) {
106. if (!u.person || !u.id) continue
107. console.log(` // ${u.person.name}`)
108. console.log(` ninetyId: '${u.id}',`)
109. }
110. console.log('\nEvery person needs one. An unpinned person resolves by display name')
111. console.log('until that name is retyped, and then resolves to nobody, which on the')
112. console.log('board is indistinguishable from having nothing to do.')
114. console.log('\n\n--- write to roster.json ---\n')
115. console.log(JSON.stringify({
116. entries: users.filter((u) => u.person && u.id).map((u) => ({ id: u.id, name: u.person!.name })),
117. }, null, 2))
118. console.log('\n pnpm roster -- --json > roster.json')
119. }
121. main().catch((err) => {
122. console.error(`\nroster failed: ${errorMessage(err)}`)
123. process.exit(1)
124. })