@aeolus-fleet/trierarch-plugin 0.0.0 → 0.20.0

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 (157) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +39 -1
  3. package/dist/adapters/crypto/idempotency-keys.d.ts +3 -0
  4. package/dist/adapters/crypto/idempotency-keys.js +4 -0
  5. package/dist/adapters/crypto/idempotency-keys.js.map +1 -0
  6. package/dist/adapters/crypto/request-hasher.d.ts +3 -0
  7. package/dist/adapters/crypto/request-hasher.js +4 -0
  8. package/dist/adapters/crypto/request-hasher.js.map +1 -0
  9. package/dist/adapters/fleet/console-sessions.d.ts +2 -0
  10. package/dist/adapters/fleet/console-sessions.js +23 -0
  11. package/dist/adapters/fleet/console-sessions.js.map +1 -0
  12. package/dist/adapters/fleet/rest-fleet-door.d.ts +2 -0
  13. package/dist/adapters/fleet/rest-fleet-door.js +122 -0
  14. package/dist/adapters/fleet/rest-fleet-door.js.map +1 -0
  15. package/dist/adapters/http/version.d.ts +6 -0
  16. package/dist/adapters/http/version.js +12 -0
  17. package/dist/adapters/http/version.js.map +1 -0
  18. package/dist/adapters/prisma/client.d.ts +10 -0
  19. package/dist/adapters/prisma/client.js +20 -0
  20. package/dist/adapters/prisma/client.js.map +1 -0
  21. package/dist/adapters/prisma/connection-store.d.ts +4 -0
  22. package/dist/adapters/prisma/connection-store.js +28 -0
  23. package/dist/adapters/prisma/connection-store.js.map +1 -0
  24. package/dist/adapters/prisma/fleet-forgetter.d.ts +4 -0
  25. package/dist/adapters/prisma/fleet-forgetter.js +10 -0
  26. package/dist/adapters/prisma/fleet-forgetter.js.map +1 -0
  27. package/dist/adapters/prisma/fleet-switches.d.ts +4 -0
  28. package/dist/adapters/prisma/fleet-switches.js +10 -0
  29. package/dist/adapters/prisma/fleet-switches.js.map +1 -0
  30. package/dist/adapters/prisma/generated/browser.d.ts +24 -0
  31. package/dist/adapters/prisma/generated/browser.js +18 -0
  32. package/dist/adapters/prisma/generated/browser.js.map +1 -0
  33. package/dist/adapters/prisma/generated/client.d.ts +43 -0
  34. package/dist/adapters/prisma/generated/client.js +38 -0
  35. package/dist/adapters/prisma/generated/client.js.map +1 -0
  36. package/dist/adapters/prisma/generated/commonInputTypes.d.ts +235 -0
  37. package/dist/adapters/prisma/generated/commonInputTypes.js +11 -0
  38. package/dist/adapters/prisma/generated/commonInputTypes.js.map +1 -0
  39. package/dist/adapters/prisma/generated/enums.d.ts +1 -0
  40. package/dist/adapters/prisma/generated/enums.js +12 -0
  41. package/dist/adapters/prisma/generated/enums.js.map +1 -0
  42. package/dist/adapters/prisma/generated/internal/class.d.ts +154 -0
  43. package/dist/adapters/prisma/generated/internal/class.js +50 -0
  44. package/dist/adapters/prisma/generated/internal/class.js.map +1 -0
  45. package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +766 -0
  46. package/dist/adapters/prisma/generated/internal/prismaNamespace.js +117 -0
  47. package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -0
  48. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +78 -0
  49. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +87 -0
  50. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -0
  51. package/dist/adapters/prisma/generated/models/Connection.d.ts +1011 -0
  52. package/dist/adapters/prisma/generated/models/Connection.js +2 -0
  53. package/dist/adapters/prisma/generated/models/Connection.js.map +1 -0
  54. package/dist/adapters/prisma/generated/models/FleetSwitch.d.ts +945 -0
  55. package/dist/adapters/prisma/generated/models/FleetSwitch.js +2 -0
  56. package/dist/adapters/prisma/generated/models/FleetSwitch.js.map +1 -0
  57. package/dist/adapters/prisma/generated/models/InstallationRequest.d.ts +1030 -0
  58. package/dist/adapters/prisma/generated/models/InstallationRequest.js +2 -0
  59. package/dist/adapters/prisma/generated/models/InstallationRequest.js.map +1 -0
  60. package/dist/adapters/prisma/generated/models.d.ts +4 -0
  61. package/dist/adapters/prisma/generated/models.js +2 -0
  62. package/dist/adapters/prisma/generated/models.js.map +1 -0
  63. package/dist/adapters/prisma/installation-requests.d.ts +4 -0
  64. package/dist/adapters/prisma/installation-requests.js +25 -0
  65. package/dist/adapters/prisma/installation-requests.js.map +1 -0
  66. package/dist/adapters/prisma/migrate.d.ts +5 -0
  67. package/dist/adapters/prisma/migrate.js +40 -0
  68. package/dist/adapters/prisma/migrate.js.map +1 -0
  69. package/dist/adapters/trpc/router.d.ts +303 -0
  70. package/dist/adapters/trpc/router.js +227 -0
  71. package/dist/adapters/trpc/router.js.map +1 -0
  72. package/dist/app.d.ts +42 -0
  73. package/dist/app.js +205 -0
  74. package/dist/app.js.map +1 -0
  75. package/dist/bin/aeolus-trierarch-plugin.d.ts +2 -0
  76. package/dist/bin/aeolus-trierarch-plugin.js +61 -0
  77. package/dist/bin/aeolus-trierarch-plugin.js.map +1 -0
  78. package/dist/config.d.ts +32 -0
  79. package/dist/config.js +49 -0
  80. package/dist/config.js.map +1 -0
  81. package/dist/core/assignment/assign-crews.d.ts +27 -0
  82. package/dist/core/assignment/assign-crews.js +49 -0
  83. package/dist/core/assignment/assign-crews.js.map +1 -0
  84. package/dist/core/assignment/check-crew-settings.d.ts +19 -0
  85. package/dist/core/assignment/check-crew-settings.js +24 -0
  86. package/dist/core/assignment/check-crew-settings.js.map +1 -0
  87. package/dist/core/assignment/placement.d.ts +59 -0
  88. package/dist/core/assignment/placement.js +113 -0
  89. package/dist/core/assignment/placement.js.map +1 -0
  90. package/dist/core/assignment/read-placement.d.ts +17 -0
  91. package/dist/core/assignment/read-placement.js +39 -0
  92. package/dist/core/assignment/read-placement.js.map +1 -0
  93. package/dist/core/connection/connect.d.ts +26 -0
  94. package/dist/core/connection/connect.js +44 -0
  95. package/dist/core/connection/connect.js.map +1 -0
  96. package/dist/core/connection/ports.d.ts +177 -0
  97. package/dist/core/connection/ports.js +2 -0
  98. package/dist/core/connection/ports.js.map +1 -0
  99. package/dist/core/connection/read-connection.d.ts +14 -0
  100. package/dist/core/connection/read-connection.js +24 -0
  101. package/dist/core/connection/read-connection.js.map +1 -0
  102. package/dist/core/installation/delete-fleet.d.ts +21 -0
  103. package/dist/core/installation/delete-fleet.js +21 -0
  104. package/dist/core/installation/delete-fleet.js.map +1 -0
  105. package/dist/core/installation/ports.d.ts +46 -0
  106. package/dist/core/installation/ports.js +2 -0
  107. package/dist/core/installation/ports.js.map +1 -0
  108. package/dist/core/installation/read-fleet.d.ts +18 -0
  109. package/dist/core/installation/read-fleet.js +9 -0
  110. package/dist/core/installation/read-fleet.js.map +1 -0
  111. package/dist/core/installation/request-id.d.ts +8 -0
  112. package/dist/core/installation/request-id.js +10 -0
  113. package/dist/core/installation/request-id.js.map +1 -0
  114. package/dist/core/installation/served.d.ts +12 -0
  115. package/dist/core/installation/served.js +8 -0
  116. package/dist/core/installation/served.js.map +1 -0
  117. package/dist/core/installation/set-fleet-enabled.d.ts +24 -0
  118. package/dist/core/installation/set-fleet-enabled.js +21 -0
  119. package/dist/core/installation/set-fleet-enabled.js.map +1 -0
  120. package/dist/core/machines/join-machine.d.ts +40 -0
  121. package/dist/core/machines/join-machine.js +35 -0
  122. package/dist/core/machines/join-machine.js.map +1 -0
  123. package/dist/core/machines/label-machines.d.ts +25 -0
  124. package/dist/core/machines/label-machines.js +120 -0
  125. package/dist/core/machines/label-machines.js.map +1 -0
  126. package/dist/core/machines/list-machines.d.ts +34 -0
  127. package/dist/core/machines/list-machines.js +47 -0
  128. package/dist/core/machines/list-machines.js.map +1 -0
  129. package/dist/core/machines/ports.d.ts +4 -0
  130. package/dist/core/machines/ports.js +2 -0
  131. package/dist/core/machines/ports.js.map +1 -0
  132. package/dist/core/machines/silent.d.ts +9 -0
  133. package/dist/core/machines/silent.js +9 -0
  134. package/dist/core/machines/silent.js.map +1 -0
  135. package/dist/core/operator/authenticate-operator.d.ts +21 -0
  136. package/dist/core/operator/authenticate-operator.js +26 -0
  137. package/dist/core/operator/authenticate-operator.js.map +1 -0
  138. package/dist/core/operator/ports.d.ts +15 -0
  139. package/dist/core/operator/ports.js +2 -0
  140. package/dist/core/operator/ports.js.map +1 -0
  141. package/dist/core/shared/clock.d.ts +4 -0
  142. package/dist/core/shared/clock.js +2 -0
  143. package/dist/core/shared/clock.js.map +1 -0
  144. package/dist/core/shared/errors.d.ts +10 -0
  145. package/dist/core/shared/errors.js +6 -0
  146. package/dist/core/shared/errors.js.map +1 -0
  147. package/dist/core/shared/result.d.ts +16 -0
  148. package/dist/core/shared/result.js +7 -0
  149. package/dist/core/shared/result.js.map +1 -0
  150. package/dist/index.d.ts +3 -0
  151. package/dist/index.js +3 -0
  152. package/dist/index.js.map +1 -0
  153. package/package.json +47 -3
  154. package/prisma.config.ts +18 -0
  155. package/src/adapters/prisma/migrations/20261006220000_init/migration.sql +35 -0
  156. package/src/adapters/prisma/migrations/migration_lock.toml +3 -0
  157. package/src/adapters/prisma/schema.prisma +58 -0
package/dist/app.d.ts ADDED
@@ -0,0 +1,42 @@
1
+ import type { FleetId } from '@aeolus-fleet/common';
2
+ import { type FastifyInstance, type FastifyServerOptions } from 'fastify';
3
+ import { type AssignOutcome } from './core/assignment/assign-crews.js';
4
+ import type { Clock } from './core/shared/clock.js';
5
+ export declare const systemClock: Clock;
6
+ export interface TrierarchPluginApp {
7
+ /** The HTTP server: `/api/health` and `/api/version` for whoever operates the installation. */
8
+ server: FastifyInstance;
9
+ /**
10
+ * At start: reads every served fleet's kept connection, dropping a crew
11
+ * token its fleet no longer takes; answers each fleet still connected, as
12
+ * which ship.
13
+ */
14
+ restoreConnections: () => Promise<{
15
+ fleetId: FleetId;
16
+ ship: string;
17
+ }[]>;
18
+ /** One assignment pass for every fleet it serves and is connected to, machine labels first; each fleet's refusal is logged, never thrown. */
19
+ assignOnce: () => Promise<{
20
+ fleetId: FleetId;
21
+ outcome: AssignOutcome;
22
+ }[]>;
23
+ /** Runs an assignment pass every interval until the app closes. */
24
+ startAssigning: (intervalMs: number) => void;
25
+ /** Stops the server and disconnects the database. */
26
+ close(): Promise<void>;
27
+ }
28
+ /**
29
+ * The trierarch plugin wired to its own database and to the fleet's public
30
+ * API. A pure API: the console's server calls it, with the console's session
31
+ * cookie; it needs no public address of its own.
32
+ */
33
+ export declare function createTrierarchPluginApp(options: {
34
+ databaseUrl: string;
35
+ fleetUrl: string;
36
+ clock?: Clock;
37
+ logger?: FastifyServerOptions['logger'];
38
+ /** The installation token (decision 0021): unset, the installation is open and every fleet is served. */
39
+ installationToken?: string;
40
+ /** A trierarch whose last seen is older than this is silent; five minutes unless given. */
41
+ silentAfterMs?: number;
42
+ }): TrierarchPluginApp;
package/dist/app.js ADDED
@@ -0,0 +1,205 @@
1
+ import { fastifyTRPCPlugin } from '@trpc/server/adapters/fastify';
2
+ import Fastify, {} from 'fastify';
3
+ import { randomIdempotencyKeys } from './adapters/crypto/idempotency-keys.js';
4
+ import { sha256RequestHasher } from './adapters/crypto/request-hasher.js';
5
+ import { createFleetConsoleSessions } from './adapters/fleet/console-sessions.js';
6
+ import { createRestFleetDoor } from './adapters/fleet/rest-fleet-door.js';
7
+ import { runningVersion } from './adapters/http/version.js';
8
+ import { checkDatabase, createPrismaClient, latestMigration } from './adapters/prisma/client.js';
9
+ import { createPrismaConnectionStore } from './adapters/prisma/connection-store.js';
10
+ import { createPrismaFleetForgetter } from './adapters/prisma/fleet-forgetter.js';
11
+ import { createPrismaFleetSwitches } from './adapters/prisma/fleet-switches.js';
12
+ import { createPrismaInstallationRequests } from './adapters/prisma/installation-requests.js';
13
+ import { trierarchPluginRouter } from './adapters/trpc/router.js';
14
+ import { createConnect } from './core/connection/connect.js';
15
+ import { createReadConnection } from './core/connection/read-connection.js';
16
+ import { createDeleteFleet } from './core/installation/delete-fleet.js';
17
+ import { createReadFleet } from './core/installation/read-fleet.js';
18
+ import { createIsServed } from './core/installation/served.js';
19
+ import { createSetFleetEnabled } from './core/installation/set-fleet-enabled.js';
20
+ import { createAssignCrews } from './core/assignment/assign-crews.js';
21
+ import { createLabelMachines } from './core/machines/label-machines.js';
22
+ import { createCheckCrewSettings } from './core/assignment/check-crew-settings.js';
23
+ import { createJoinMachine } from './core/machines/join-machine.js';
24
+ import { createListMachines } from './core/machines/list-machines.js';
25
+ import { createAuthenticateOperator } from './core/operator/authenticate-operator.js';
26
+ export const systemClock = { now: () => new Date() };
27
+ /** A trierarch is silent once its last seen is older than this, unless the configuration says otherwise. */
28
+ const DEFAULT_SILENT_AFTER_MS = 300_000;
29
+ /**
30
+ * The trierarch plugin wired to its own database and to the fleet's public
31
+ * API. A pure API: the console's server calls it, with the console's session
32
+ * cookie; it needs no public address of its own.
33
+ */
34
+ export function createTrierarchPluginApp(options) {
35
+ const prisma = createPrismaClient(options.databaseUrl);
36
+ const server = Fastify({ logger: options.logger ?? true });
37
+ const connections = createPrismaConnectionStore(prisma);
38
+ const installation = options.installationToken === undefined ? 'open' : 'enabled';
39
+ const switches = createPrismaFleetSwitches(prisma);
40
+ const isServed = createIsServed({ installation, switches });
41
+ // From what the trierarch plugin holds, without asking any fleet: health and version stay quick.
42
+ const connectedFleets = async () => (await connections.connected()).length;
43
+ // The version this process runs and its database's latest migration. No authentication, no fleet data.
44
+ const version = runningVersion();
45
+ server.get('/api/version', async () => {
46
+ let migration = null;
47
+ try {
48
+ migration = await latestMigration(prisma);
49
+ }
50
+ catch (error) {
51
+ server.log.error({ err: error }, 'latest migration unknown');
52
+ }
53
+ return { trierarchPlugin: version, migration, connectedFleets: await connectedFleets(), installation };
54
+ });
55
+ // Up and its database reachable.
56
+ server.get('/api/health', async (_request, reply) => {
57
+ try {
58
+ await checkDatabase(prisma);
59
+ return { status: 'ok', connectedFleets: await connectedFleets(), installation };
60
+ }
61
+ catch (error) {
62
+ server.log.error({ err: error }, 'database unreachable');
63
+ return reply.code(503).send({ status: 'unavailable' });
64
+ }
65
+ });
66
+ const clock = options.clock ?? systemClock;
67
+ const door = createRestFleetDoor(options.fleetUrl);
68
+ const readConnection = createReadConnection({ door, store: connections });
69
+ // A fleet's connection as the trierarch plugin holds it, asking the fleet nothing: what a fleet that is off reads.
70
+ const heldConnection = async (fleetId) => {
71
+ const crew = await connections.find(fleetId);
72
+ if (crew) {
73
+ return { state: 'connected', ship: { shipId: crew.shipId, name: crew.name }, lastShipId: crew.shipId };
74
+ }
75
+ return { state: 'not-connected', ship: null, lastShipId: (await connections.binding(fleetId))?.shipId ?? null };
76
+ };
77
+ const requests = createPrismaInstallationRequests(prisma);
78
+ const setFleetEnabled = createSetFleetEnabled({ switches, requests, hasher: sha256RequestHasher, clock });
79
+ const readFleet = createReadFleet({ isServed, connections });
80
+ const deleteFleet = createDeleteFleet({ forgetter: createPrismaFleetForgetter(prisma), requests, hasher: sha256RequestHasher, clock });
81
+ const connect = createConnect({ door, store: connections, clock });
82
+ const joinMachine = createJoinMachine({ door, connections, keys: randomIdempotencyKeys, fleetUrl: options.fleetUrl });
83
+ const silentAfterMs = options.silentAfterMs ?? DEFAULT_SILENT_AFTER_MS;
84
+ const listMachines = createListMachines({ door, connections, clock, silentAfterMs });
85
+ const assignCrews = createAssignCrews({ door, connections, clock, silentAfterMs });
86
+ const labelMachines = createLabelMachines({ door, connections });
87
+ /** The fleets whose machine labels were last skipped, so the reason is logged once, not every pass. */
88
+ const skippedLabels = new Set();
89
+ /** Labels each trierarch ship from its machine before placement reads the labels; a refusal is logged and assignment goes on. */
90
+ const labelOnce = async (fleetId) => {
91
+ const labelled = await labelMachines(fleetId);
92
+ if (!labelled.isOk) {
93
+ server.log.warn({ fleet: fleetId, refusal: labelled.error }, 'machine labels refused; the next pass tries again');
94
+ return;
95
+ }
96
+ const { skipped, ...outcome } = labelled.value;
97
+ if (skipped !== undefined) {
98
+ if (!skippedLabels.has(fleetId)) {
99
+ server.log.warn({ fleet: fleetId }, `machine labels skipped: ${skipped}`);
100
+ }
101
+ skippedLabels.add(fleetId);
102
+ return;
103
+ }
104
+ skippedLabels.delete(fleetId);
105
+ if (outcome.defined + outcome.assigned + outcome.unassigned > 0) {
106
+ server.log.info({ fleet: fleetId, ...outcome }, 'machine labels');
107
+ }
108
+ };
109
+ const checkCrewSettings = createCheckCrewSettings({ door, connections, clock, silentAfterMs });
110
+ const assignOnce = async () => {
111
+ const done = [];
112
+ for (const crew of await connections.connected()) {
113
+ if (!(await isServed(crew.fleetId))) {
114
+ continue;
115
+ }
116
+ await labelOnce(crew.fleetId);
117
+ const assigned = await assignCrews(crew.fleetId);
118
+ if (assigned.isOk) {
119
+ done.push({ fleetId: crew.fleetId, outcome: assigned.value });
120
+ }
121
+ else {
122
+ server.log.warn({ fleet: crew.fleetId, refusal: assigned.error }, 'assignment pass refused; the next pass tries again');
123
+ }
124
+ }
125
+ return done;
126
+ };
127
+ let assigning;
128
+ const trpc = {
129
+ prefix: '/trpc',
130
+ trpcOptions: {
131
+ router: trierarchPluginRouter,
132
+ onError: ({ error, path }) => {
133
+ if (error.code === 'INTERNAL_SERVER_ERROR') {
134
+ server.log.error({ err: error.cause ?? error, path }, 'procedure failed');
135
+ }
136
+ },
137
+ createContext: ({ req }) => ({
138
+ cookie: req.headers.cookie,
139
+ authenticateOperator: createAuthenticateOperator({ sessions: createFleetConsoleSessions(options.fleetUrl) }),
140
+ isConnected: async (fleetId) => (await connections.find(fleetId)) !== undefined,
141
+ isServed,
142
+ heldConnection,
143
+ installationTokenSent: typeof req.headers['x-aeolus-installation-token'] === 'string' ? req.headers['x-aeolus-installation-token'] : undefined,
144
+ installation: { mode: installation, token: options.installationToken },
145
+ setFleetEnabled,
146
+ readFleet,
147
+ deleteFleet,
148
+ readConnection,
149
+ connect,
150
+ joinMachine,
151
+ listMachines,
152
+ checkCrewSettings,
153
+ }),
154
+ },
155
+ };
156
+ void server.register(fastifyTRPCPlugin, trpc);
157
+ server.addHook('onClose', async () => {
158
+ clearInterval(assigning);
159
+ await prisma.$disconnect();
160
+ });
161
+ return {
162
+ server,
163
+ restoreConnections: async () => {
164
+ const restored = [];
165
+ for (const crew of await connections.connected()) {
166
+ // A fleet that is off rests: its connection waits, unread, for it to be on again.
167
+ if (!(await isServed(crew.fleetId))) {
168
+ continue;
169
+ }
170
+ const connection = await readConnection(crew.fleetId);
171
+ if (connection.state === 'connected') {
172
+ restored.push({ fleetId: crew.fleetId, ship: connection.ship?.name ?? crew.name });
173
+ }
174
+ }
175
+ return restored;
176
+ },
177
+ assignOnce,
178
+ startAssigning: (intervalMs) => {
179
+ // One pass at a time: a pass that outlasts the interval makes the next one wait.
180
+ let isPassing = false;
181
+ assigning = setInterval(() => {
182
+ if (isPassing) {
183
+ return;
184
+ }
185
+ isPassing = true;
186
+ assignOnce()
187
+ .then((done) => {
188
+ for (const { fleetId, outcome } of done) {
189
+ if (outcome.assigned + outcome.explained + outcome.lost > 0) {
190
+ server.log.info({ fleet: fleetId, ...outcome }, 'assignment pass');
191
+ }
192
+ }
193
+ })
194
+ .catch((error) => {
195
+ server.log.error({ err: error }, 'assignment pass failed; the next pass tries again');
196
+ })
197
+ .finally(() => {
198
+ isPassing = false;
199
+ });
200
+ }, intervalMs);
201
+ },
202
+ close: () => server.close(),
203
+ };
204
+ }
205
+ //# sourceMappingURL=app.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,61 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * `aeolus-trierarch-plugin start`: migrates the trierarch plugin's database,
4
+ * connects again to every fleet with its kept crew token (a fleet without one
5
+ * is not connected until its operator connects the trierarch plugin in the
6
+ * console), then serves and runs an assignment pass every interval until
7
+ * SIGINT or SIGTERM. `aeolus-trierarch-plugin
8
+ * migrate`: migrates the database alone.
9
+ */
10
+ import { MigrationError, migrateDatabase } from '../adapters/prisma/migrate.js';
11
+ import { createTrierarchPluginApp } from '../app.js';
12
+ import { ConfigError, loadConfig, loadDatabaseUrl } from '../config.js';
13
+ const USAGE = 'Usage: aeolus-trierarch-plugin start | migrate';
14
+ async function start() {
15
+ const config = loadConfig(process.env);
16
+ await migrateDatabase(config.databaseUrl);
17
+ const app = createTrierarchPluginApp({
18
+ databaseUrl: config.databaseUrl,
19
+ fleetUrl: config.fleetUrl,
20
+ logger: { level: config.logLevel },
21
+ silentAfterMs: config.silentAfterMs,
22
+ ...(config.installationToken === undefined ? {} : { installationToken: config.installationToken }),
23
+ });
24
+ const restored = await app.restoreConnections();
25
+ for (const { fleetId, ship } of restored) {
26
+ app.server.log.info({ fleet: fleetId, ship }, "connected as the trierarch plugin's ship");
27
+ }
28
+ if (restored.length === 0) {
29
+ app.server.log.warn('connected to no fleet: an operator connects the trierarch plugin in the console');
30
+ }
31
+ app.startAssigning(config.passIntervalMs);
32
+ for (const signal of ['SIGINT', 'SIGTERM']) {
33
+ process.once(signal, () => {
34
+ void app.close().then(() => process.exit(0));
35
+ });
36
+ }
37
+ await app.server.listen({ host: config.host, port: config.port });
38
+ }
39
+ try {
40
+ switch (process.argv[2] ?? '') {
41
+ case 'start':
42
+ await start();
43
+ break;
44
+ case 'migrate':
45
+ await migrateDatabase(loadDatabaseUrl(process.env));
46
+ break;
47
+ default:
48
+ process.stderr.write(`${USAGE}\n`);
49
+ process.exitCode = 2;
50
+ }
51
+ }
52
+ catch (error) {
53
+ if (error instanceof ConfigError || error instanceof MigrationError) {
54
+ process.stderr.write(`${error.message}\n`);
55
+ process.exitCode = 1;
56
+ }
57
+ else {
58
+ throw error;
59
+ }
60
+ }
61
+ //# sourceMappingURL=aeolus-trierarch-plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"aeolus-trierarch-plugin.js","sourceRoot":"","sources":["../../src/bin/aeolus-trierarch-plugin.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,KAAK,GAAG,gDAAgD,CAAC;AAE/D,KAAK,UAAU,KAAK;IAClB,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,wBAAwB,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE;QAClC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;KACnG,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC;IAChD,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,0CAA0C,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IACzG,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,IAAI,CAAC;IACH,QAAQ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,KAAK,OAAO;YACV,MAAM,KAAK,EAAE,CAAC;YACd,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,MAAM;QACR;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;YACnC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
@@ -0,0 +1,32 @@
1
+ export interface Config {
2
+ /** The trierarch plugin's own database (decision 0030), which may share the Postgres server with the fleet and squadrons. */
3
+ databaseUrl: string;
4
+ /**
5
+ * The fleet's public URL, where the trierarch plugin calls the ship API as
6
+ * its ship and checks console sessions, and which a joining machine's setup
7
+ * line names. Not a secret; fixed here, so no caller can point the trierarch
8
+ * plugin at another fleet. Its ship's secret is never configured: the
9
+ * operator connects the trierarch plugin in the console.
10
+ */
11
+ fleetUrl: string;
12
+ host: string;
13
+ port: number;
14
+ logLevel: string;
15
+ /**
16
+ * The token a hosting service presents to the installation procedures
17
+ * (decision 0021). Unset, they are off and every fleet is served, as
18
+ * a self-hosted trierarch plugin needs; set, a fleet is served once switched on.
19
+ */
20
+ installationToken: string | undefined;
21
+ /** A trierarch whose last seen is older than this is silent: it gets no new requests, and keeps those it holds. */
22
+ silentAfterMs: number;
23
+ /** How often the assignment runs a pass for each fleet it serves and is connected to. */
24
+ passIntervalMs: number;
25
+ }
26
+ export declare class ConfigError extends Error {
27
+ name: string;
28
+ }
29
+ /** The configuration from the environment; throws a ConfigError naming every variable that is wrong. */
30
+ export declare function loadConfig(environment: Record<string, string | undefined>): Config;
31
+ /** The database URL alone, for `aeolus-trierarch-plugin migrate`. */
32
+ export declare function loadDatabaseUrl(environment: Record<string, string | undefined>): string;
package/dist/config.js ADDED
@@ -0,0 +1,49 @@
1
+ import { z } from 'zod';
2
+ /** The shortest installation token the trierarch plugin takes, as the fleet core does (decision 0020). */
3
+ const INSTALLATION_TOKEN_MIN_LENGTH = 32;
4
+ /** A trierarch is silent once its last seen is older than this, by default (docs/trierarch.md, "Assignment"). */
5
+ const DEFAULT_SILENT_AFTER_SECONDS = 300;
6
+ /** How often the assignment runs a pass per fleet, by default. */
7
+ const DEFAULT_PASS_INTERVAL_SECONDS = 10;
8
+ const MS_PER_SECOND = 1000;
9
+ const environmentSchema = z.object({
10
+ DATABASE_URL: z.url({ protocol: /^postgres(ql)?$/, error: 'must be a postgres:// or postgresql:// URL' }),
11
+ FLEET_URL: z.url({ protocol: /^https?$/, error: 'must be an http:// or https:// URL' }),
12
+ HOST: z.string().min(1).default('127.0.0.1'),
13
+ PORT: z.coerce.number().int().min(0).max(65_535).default(4200),
14
+ LOG_LEVEL: z.enum(['fatal', 'error', 'warn', 'info', 'debug', 'trace', 'silent']).default('info'),
15
+ INSTALLATION_TOKEN: z.string().min(INSTALLATION_TOKEN_MIN_LENGTH, { error: `must hold at least ${String(INSTALLATION_TOKEN_MIN_LENGTH)} characters` }).optional(),
16
+ TRIERARCH_SILENT_AFTER_SECONDS: z.coerce.number().int().positive().default(DEFAULT_SILENT_AFTER_SECONDS),
17
+ TRIERARCH_PASS_INTERVAL_SECONDS: z.coerce.number().int().positive().default(DEFAULT_PASS_INTERVAL_SECONDS),
18
+ });
19
+ /** What `aeolus-trierarch-plugin migrate` reads: the database alone. */
20
+ const databaseEnvironmentSchema = environmentSchema.pick({ DATABASE_URL: true });
21
+ export class ConfigError extends Error {
22
+ name = 'ConfigError';
23
+ }
24
+ function parsed(schema, environment) {
25
+ const result = schema.safeParse(environment);
26
+ if (!result.success) {
27
+ throw new ConfigError(result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('\n'));
28
+ }
29
+ return result.data;
30
+ }
31
+ /** The configuration from the environment; throws a ConfigError naming every variable that is wrong. */
32
+ export function loadConfig(environment) {
33
+ const variables = parsed(environmentSchema, environment);
34
+ return {
35
+ databaseUrl: variables.DATABASE_URL,
36
+ fleetUrl: variables.FLEET_URL.replace(/\/$/, ''),
37
+ host: variables.HOST,
38
+ port: variables.PORT,
39
+ logLevel: variables.LOG_LEVEL,
40
+ installationToken: variables.INSTALLATION_TOKEN,
41
+ silentAfterMs: variables.TRIERARCH_SILENT_AFTER_SECONDS * MS_PER_SECOND,
42
+ passIntervalMs: variables.TRIERARCH_PASS_INTERVAL_SECONDS * MS_PER_SECOND,
43
+ };
44
+ }
45
+ /** The database URL alone, for `aeolus-trierarch-plugin migrate`. */
46
+ export function loadDatabaseUrl(environment) {
47
+ return parsed(databaseEnvironmentSchema, environment).DATABASE_URL;
48
+ }
49
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import type { FleetId } from '@aeolus-fleet/common';
2
+ import type { ConnectionStore, FleetDoor } from '../connection/ports.js';
3
+ import type { Clock } from '../shared/clock.js';
4
+ import { type DomainError } from '../shared/errors.js';
5
+ import { type Result } from '../shared/result.js';
6
+ /** What a pass did: the claims it won, the reasons it wrote, and the claims another assigner or a change won first. */
7
+ export interface AssignOutcome {
8
+ assigned: number;
9
+ explained: number;
10
+ lost: number;
11
+ }
12
+ export type AssignCrews = (fleetId: FleetId) => Promise<Result<AssignOutcome, DomainError<'NOT_CONNECTED' | 'FLEET_UNAVAILABLE'>>>;
13
+ /**
14
+ * Use case: one pass of assignment for a fleet (docs/trierarch.md,
15
+ * "Assignment"). It reads the fleet whole each time: the unassigned requests
16
+ * of ships that await crew, and the trierarchs that report details and are
17
+ * not silent, with the requests assigned to each. Placement decides; each
18
+ * claim is optimistic, and one the fleet refuses because the request changed
19
+ * is no error: the next pass reads it again. A silent trierarch gets nothing
20
+ * new and keeps what it holds.
21
+ */
22
+ export declare function createAssignCrews(deps: {
23
+ door: FleetDoor;
24
+ connections: ConnectionStore;
25
+ clock: Clock;
26
+ silentAfterMs: number;
27
+ }): AssignCrews;
@@ -0,0 +1,49 @@
1
+ import { refuse } from '../shared/errors.js';
2
+ import { ok } from '../shared/result.js';
3
+ import { place } from './placement.js';
4
+ import { readPlacement } from './read-placement.js';
5
+ /** The refusals that mean the request changed since it was read (claimed, crewed or removed): read again on the next pass. */
6
+ const CHANGED = new Set(['CONFLICT', 'NOT_FOUND']);
7
+ /**
8
+ * Use case: one pass of assignment for a fleet (docs/trierarch.md,
9
+ * "Assignment"). It reads the fleet whole each time: the unassigned requests
10
+ * of ships that await crew, and the trierarchs that report details and are
11
+ * not silent, with the requests assigned to each. Placement decides; each
12
+ * claim is optimistic, and one the fleet refuses because the request changed
13
+ * is no error: the next pass reads it again. A silent trierarch gets nothing
14
+ * new and keeps what it holds.
15
+ */
16
+ export function createAssignCrews(deps) {
17
+ const unavailable = (refusal) => refuse('FLEET_UNAVAILABLE', `The fleet did not answer the assignment: ${refusal.message}`);
18
+ return async (fleetId) => {
19
+ const crew = await deps.connections.find(fleetId);
20
+ if (!crew) {
21
+ return refuse('NOT_CONNECTED', 'The trierarch plugin is not connected to this fleet: connect it in the console');
22
+ }
23
+ const read = await readPlacement(deps.door, { crewToken: crew.crewToken, now: deps.clock.now(), silentAfterMs: deps.silentAfterMs });
24
+ if (!read.isOk) {
25
+ return unavailable(read.error);
26
+ }
27
+ const { requests, trierarchs } = read.value;
28
+ const outcome = { assigned: 0, explained: 0, lost: 0 };
29
+ for (const placement of place(requests, trierarchs)) {
30
+ const done = placement.kind === 'assign'
31
+ ? await deps.door.assignCrew(crew.crewToken, { shipId: placement.shipId, trierarchShipId: placement.trierarchShipId })
32
+ : await deps.door.explainCrewRequest(crew.crewToken, { shipId: placement.shipId, reason: placement.reason });
33
+ if (!done.isOk && !CHANGED.has(done.error.code)) {
34
+ return unavailable(done.error);
35
+ }
36
+ if (placement.kind === 'explain') {
37
+ outcome.explained += done.isOk ? 1 : 0;
38
+ }
39
+ else if (done.isOk) {
40
+ outcome.assigned += 1;
41
+ }
42
+ else {
43
+ outcome.lost += 1;
44
+ }
45
+ }
46
+ return ok(outcome);
47
+ };
48
+ }
49
+ //# sourceMappingURL=assign-crews.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assign-crews.js","sourceRoot":"","sources":["../../../src/core/assignment/assign-crews.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,8HAA8H;AAC9H,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA4F;IAC5H,MAAM,WAAW,GAAG,CAAC,OAAqB,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE,4CAA4C,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1I,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,eAAe,EAAE,gFAAgF,CAAC,CAAC;QACnH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACrI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAE5C,MAAM,OAAO,GAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GACR,SAAS,CAAC,IAAI,KAAK,QAAQ;gBACzB,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC;gBACtH,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YACjH,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YACD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { FleetId } from '@aeolus-fleet/common';
2
+ import type { ConnectionStore, FleetDoor } from '../connection/ports.js';
3
+ import type { Clock } from '../shared/clock.js';
4
+ import { type DomainError } from '../shared/errors.js';
5
+ import { type Result } from '../shared/result.js';
6
+ import { type PlacementCheck } from './placement.js';
7
+ export type CheckCrewSettings = (fleetId: FleetId, settings: unknown) => Promise<Result<PlacementCheck, DomainError<'NOT_CONNECTED' | 'FLEET_UNAVAILABLE'>>>;
8
+ /**
9
+ * Use case: whether crew settings would be placed now, before a request is
10
+ * made (#245): read the fleet's trierarchs as assignment does, and check the
11
+ * settings by placement's rules. It writes nothing; the request itself goes
12
+ * to the fleet, and assignment places it as always.
13
+ */
14
+ export declare function createCheckCrewSettings(deps: {
15
+ door: FleetDoor;
16
+ connections: ConnectionStore;
17
+ clock: Clock;
18
+ silentAfterMs: number;
19
+ }): CheckCrewSettings;
@@ -0,0 +1,24 @@
1
+ import { refuse } from '../shared/errors.js';
2
+ import { ok } from '../shared/result.js';
3
+ import { checkPlacement } from './placement.js';
4
+ import { readPlacement } from './read-placement.js';
5
+ /**
6
+ * Use case: whether crew settings would be placed now, before a request is
7
+ * made (#245): read the fleet's trierarchs as assignment does, and check the
8
+ * settings by placement's rules. It writes nothing; the request itself goes
9
+ * to the fleet, and assignment places it as always.
10
+ */
11
+ export function createCheckCrewSettings(deps) {
12
+ return async (fleetId, settings) => {
13
+ const crew = await deps.connections.find(fleetId);
14
+ if (!crew) {
15
+ return refuse('NOT_CONNECTED', 'The trierarch plugin is not connected to this fleet: connect it in the console');
16
+ }
17
+ const read = await readPlacement(deps.door, { crewToken: crew.crewToken, now: deps.clock.now(), silentAfterMs: deps.silentAfterMs });
18
+ if (!read.isOk) {
19
+ return refuse('FLEET_UNAVAILABLE', `The fleet did not answer the check: ${read.error.message}`);
20
+ }
21
+ return ok(checkPlacement(settings, read.value.trierarchs));
22
+ };
23
+ }
24
+ //# sourceMappingURL=check-crew-settings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check-crew-settings.js","sourceRoot":"","sources":["../../../src/core/assignment/check-crew-settings.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAuB,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA4F;IAClI,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,eAAe,EAAE,gFAAgF,CAAC,CAAC;QACnH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACrI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,mBAAmB,EAAE,uCAAuC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,59 @@
1
+ import { type ShipId, type TrierarchReportDetails } from '@aeolus-fleet/common';
2
+ /** An unassigned crew request whose ship awaits crew: its settings as the fleet holds them, and the reason written on it now. */
3
+ export interface PlacementRequest {
4
+ shipId: ShipId;
5
+ requestedAt: Date;
6
+ /** Unread: placement parses them as crew settings. */
7
+ settings: unknown;
8
+ reason: string | null;
9
+ }
10
+ /** A trierarch that may take requests: one that reports details and is not silent. */
11
+ export interface PlacementTrierarch {
12
+ shipId: ShipId;
13
+ commissionedAt: Date;
14
+ details: TrierarchReportDetails;
15
+ /** The requests assigned to it now. */
16
+ assigned: number;
17
+ /** The label values its ship carries, every owner's: what a request's machine labels match (#102). */
18
+ labelValueIds: readonly string[];
19
+ }
20
+ /** What placement decides for a request: the trierarch to claim it for, or why none fits. */
21
+ export type Placement = {
22
+ kind: 'assign';
23
+ shipId: ShipId;
24
+ trierarchShipId: ShipId;
25
+ } | {
26
+ kind: 'explain';
27
+ shipId: ShipId;
28
+ reason: string;
29
+ };
30
+ /**
31
+ * What a settings check answers before a request is made: a trierarch fits;
32
+ * none takes them, naming the settings field at fault; or they fit, but no
33
+ * trierarch has room now, so a request would wait.
34
+ */
35
+ export type PlacementCheck = {
36
+ kind: 'fits';
37
+ } | {
38
+ kind: 'refused';
39
+ field: string;
40
+ reason: string;
41
+ } | {
42
+ kind: 'noRoom';
43
+ reason: string;
44
+ };
45
+ /**
46
+ * Policy: whether settings would be placed now, before anything is requested
47
+ * (#245): by the same rules as placement, against the trierarchs as they are.
48
+ */
49
+ export declare function checkPlacement(settings: unknown, trierarchs: readonly PlacementTrierarch[]): PlacementCheck;
50
+ /**
51
+ * Policy: where each unassigned request goes (docs/trierarch.md,
52
+ * "Assignment"). Oldest request first, each to a trierarch whose ship
53
+ * carries every machine label it names, that offers its harness and workspace, takes its options against the schema it reports for
54
+ * that harness, and has room (its cap above the requests assigned to it);
55
+ * of those, the most room as a share of its cap, then the oldest. What it
56
+ * assigns counts against the room of later requests in the same pass. A
57
+ * request none fits gets the reason, unless that reason is written already.
58
+ */
59
+ export declare function place(requests: readonly PlacementRequest[], trierarchs: readonly PlacementTrierarch[]): Placement[];