@aeolus-fleet/core 0.29.2 → 0.30.1

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 (236) hide show
  1. package/README.md +21 -0
  2. package/dist/adapters/http/server.js +5 -0
  3. package/dist/adapters/http/server.js.map +1 -1
  4. package/dist/adapters/prisma/generated/browser.d.ts +24 -0
  5. package/dist/adapters/prisma/generated/client.d.ts +24 -0
  6. package/dist/adapters/prisma/generated/commonInputTypes.d.ts +30 -0
  7. package/dist/adapters/prisma/generated/internal/class.d.ts +33 -0
  8. package/dist/adapters/prisma/generated/internal/class.js +4 -4
  9. package/dist/adapters/prisma/generated/internal/class.js.map +1 -1
  10. package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +262 -1
  11. package/dist/adapters/prisma/generated/internal/prismaNamespace.js +33 -0
  12. package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -1
  13. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +36 -0
  14. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +33 -0
  15. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -1
  16. package/dist/adapters/prisma/generated/models/Fleet.d.ts +993 -0
  17. package/dist/adapters/prisma/generated/models/HealthSnapshot.d.ts +1282 -0
  18. package/dist/adapters/prisma/generated/models/HealthSnapshot.js +2 -0
  19. package/dist/adapters/prisma/generated/models/HealthSnapshot.js.map +1 -0
  20. package/dist/adapters/prisma/generated/models/HealthSnapshotDelivery.d.ts +1470 -0
  21. package/dist/adapters/prisma/generated/models/HealthSnapshotDelivery.js +2 -0
  22. package/dist/adapters/prisma/generated/models/HealthSnapshotDelivery.js.map +1 -0
  23. package/dist/adapters/prisma/generated/models/MessageDay.d.ts +1193 -0
  24. package/dist/adapters/prisma/generated/models/MessageDay.js +2 -0
  25. package/dist/adapters/prisma/generated/models/MessageDay.js.map +1 -0
  26. package/dist/adapters/prisma/generated/models.d.ts +3 -0
  27. package/dist/adapters/prisma/health-snapshots.d.ts +30 -0
  28. package/dist/adapters/prisma/health-snapshots.js +250 -0
  29. package/dist/adapters/prisma/health-snapshots.js.map +1 -0
  30. package/dist/adapters/prisma/health.d.ts +58 -1
  31. package/dist/adapters/prisma/health.js +157 -65
  32. package/dist/adapters/prisma/health.js.map +1 -1
  33. package/dist/adapters/prisma/history.d.ts +19 -0
  34. package/dist/adapters/prisma/history.js +167 -69
  35. package/dist/adapters/prisma/history.js.map +1 -1
  36. package/dist/adapters/prisma/installation.d.ts +5 -1
  37. package/dist/adapters/prisma/installation.js +27 -11
  38. package/dist/adapters/prisma/installation.js.map +1 -1
  39. package/dist/adapters/prisma/messaging.d.ts +12 -1
  40. package/dist/adapters/prisma/messaging.js +33 -1
  41. package/dist/adapters/prisma/messaging.js.map +1 -1
  42. package/dist/adapters/prisma/network.js +4 -3
  43. package/dist/adapters/prisma/network.js.map +1 -1
  44. package/dist/adapters/prisma/registry.d.ts +26 -7
  45. package/dist/adapters/prisma/registry.js +291 -12
  46. package/dist/adapters/prisma/registry.js.map +1 -1
  47. package/dist/adapters/prisma/ship-counts.d.ts +34 -0
  48. package/dist/adapters/prisma/ship-counts.js +116 -0
  49. package/dist/adapters/prisma/ship-counts.js.map +1 -0
  50. package/dist/adapters/prisma/telemetry.d.ts +5 -0
  51. package/dist/adapters/prisma/telemetry.js +40 -0
  52. package/dist/adapters/prisma/telemetry.js.map +1 -0
  53. package/dist/adapters/prisma/unit-of-work.d.ts +13 -3
  54. package/dist/adapters/prisma/unit-of-work.js +13 -1
  55. package/dist/adapters/prisma/unit-of-work.js.map +1 -1
  56. package/dist/adapters/telemetry/calls.d.ts +14 -0
  57. package/dist/adapters/telemetry/calls.js +48 -0
  58. package/dist/adapters/telemetry/calls.js.map +1 -0
  59. package/dist/adapters/telemetry/requests.d.ts +8 -0
  60. package/dist/adapters/telemetry/requests.js +28 -0
  61. package/dist/adapters/telemetry/requests.js.map +1 -0
  62. package/dist/adapters/telemetry/sdk.d.ts +2 -0
  63. package/dist/adapters/telemetry/sdk.js +40 -0
  64. package/dist/adapters/telemetry/sdk.js.map +1 -0
  65. package/dist/adapters/telemetry/telemetry.d.ts +21 -0
  66. package/dist/adapters/telemetry/telemetry.js +16 -0
  67. package/dist/adapters/telemetry/telemetry.js.map +1 -0
  68. package/dist/adapters/trpc/context.d.ts +28 -0
  69. package/dist/adapters/trpc/fleet.d.ts +721 -243
  70. package/dist/adapters/trpc/fleet.js +171 -44
  71. package/dist/adapters/trpc/fleet.js.map +1 -1
  72. package/dist/adapters/trpc/health.d.ts +42 -1
  73. package/dist/adapters/trpc/health.js +18 -10
  74. package/dist/adapters/trpc/health.js.map +1 -1
  75. package/dist/adapters/trpc/installation.d.ts +2 -2
  76. package/dist/adapters/trpc/router.d.ts +694 -233
  77. package/dist/adapters/trpc/ship-contract.js +3 -0
  78. package/dist/adapters/trpc/ship-contract.js.map +1 -1
  79. package/dist/adapters/trpc/ship.d.ts +6 -4
  80. package/dist/adapters/trpc/ship.js +5 -2
  81. package/dist/adapters/trpc/ship.js.map +1 -1
  82. package/dist/adapters/trpc/trpc.d.ts +8 -0
  83. package/dist/adapters/trpc/trpc.js +35 -1
  84. package/dist/adapters/trpc/trpc.js.map +1 -1
  85. package/dist/app.d.ts +2 -1
  86. package/dist/app.js +11 -3
  87. package/dist/app.js.map +1 -1
  88. package/dist/domain/messaging/check-inbox.d.ts +12 -4
  89. package/dist/domain/messaging/check-inbox.js +16 -7
  90. package/dist/domain/messaging/check-inbox.js.map +1 -1
  91. package/dist/domain/messaging/daily-message-limit.d.ts +1 -1
  92. package/dist/domain/messaging/daily-message-limit.js +1 -1
  93. package/dist/domain/messaging/daily-message-limit.js.map +1 -1
  94. package/dist/domain/messaging/ports.d.ts +2 -2
  95. package/dist/domain/registry/check-network-rules-file.d.ts +38 -0
  96. package/dist/domain/registry/check-network-rules-file.js +50 -0
  97. package/dist/domain/registry/check-network-rules-file.js.map +1 -0
  98. package/dist/domain/registry/count-ships.d.ts +18 -0
  99. package/dist/domain/registry/count-ships.js +10 -0
  100. package/dist/domain/registry/count-ships.js.map +1 -0
  101. package/dist/domain/registry/export-network-rules.d.ts +27 -0
  102. package/dist/domain/registry/export-network-rules.js +55 -0
  103. package/dist/domain/registry/export-network-rules.js.map +1 -0
  104. package/dist/domain/registry/found-fleet.d.ts +5 -1
  105. package/dist/domain/registry/found-fleet.js +5 -1
  106. package/dist/domain/registry/found-fleet.js.map +1 -1
  107. package/dist/domain/registry/get-installation-fleet.d.ts +3 -1
  108. package/dist/domain/registry/get-installation-fleet.js +2 -2
  109. package/dist/domain/registry/get-installation-fleet.js.map +1 -1
  110. package/dist/domain/registry/import-network-rules.d.ts +40 -0
  111. package/dist/domain/registry/import-network-rules.js +98 -0
  112. package/dist/domain/registry/import-network-rules.js.map +1 -0
  113. package/dist/domain/registry/label.d.ts +2 -6
  114. package/dist/domain/registry/label.js +1 -9
  115. package/dist/domain/registry/label.js.map +1 -1
  116. package/dist/domain/registry/list-fleet.d.ts +21 -10
  117. package/dist/domain/registry/list-fleet.js +20 -11
  118. package/dist/domain/registry/list-fleet.js.map +1 -1
  119. package/dist/domain/registry/list-installation-fleets.d.ts +3 -1
  120. package/dist/domain/registry/list-installation-fleets.js +2 -2
  121. package/dist/domain/registry/list-installation-fleets.js.map +1 -1
  122. package/dist/domain/registry/list-labels.d.ts +16 -5
  123. package/dist/domain/registry/list-labels.js +12 -3
  124. package/dist/domain/registry/list-labels.js.map +1 -1
  125. package/dist/domain/registry/list-ship-types.d.ts +18 -0
  126. package/dist/domain/registry/list-ship-types.js +12 -0
  127. package/dist/domain/registry/list-ship-types.js.map +1 -0
  128. package/dist/domain/registry/network-rules-file.d.ts +91 -0
  129. package/dist/domain/registry/network-rules-file.js +292 -0
  130. package/dist/domain/registry/network-rules-file.js.map +1 -0
  131. package/dist/domain/registry/network-settings.d.ts +15 -0
  132. package/dist/domain/registry/network-settings.js +18 -13
  133. package/dist/domain/registry/network-settings.js.map +1 -1
  134. package/dist/domain/registry/ports.d.ts +45 -4
  135. package/dist/domain/registry/read-listed-ship.d.ts +21 -0
  136. package/dist/domain/registry/read-listed-ship.js +22 -0
  137. package/dist/domain/registry/read-listed-ship.js.map +1 -0
  138. package/dist/domain/registry/read-reach-refusals.d.ts +8 -3
  139. package/dist/domain/registry/read-reach-refusals.js +6 -7
  140. package/dist/domain/registry/read-reach-refusals.js.map +1 -1
  141. package/dist/domain/registry/ship-counts.d.ts +28 -0
  142. package/dist/domain/registry/ship-counts.js +35 -0
  143. package/dist/domain/registry/ship-counts.js.map +1 -0
  144. package/dist/domain/registry/ship-order.d.ts +29 -0
  145. package/dist/domain/registry/ship-order.js +54 -0
  146. package/dist/domain/registry/ship-order.js.map +1 -0
  147. package/dist/domain/shared/close-health-snapshots.d.ts +24 -0
  148. package/dist/domain/shared/close-health-snapshots.js +67 -0
  149. package/dist/domain/shared/close-health-snapshots.js.map +1 -0
  150. package/dist/domain/shared/count-open-inbox.d.ts +20 -0
  151. package/dist/domain/shared/count-open-inbox.js +26 -0
  152. package/dist/domain/shared/count-open-inbox.js.map +1 -0
  153. package/dist/domain/shared/errors.d.ts +1 -1
  154. package/dist/domain/shared/errors.js.map +1 -1
  155. package/dist/domain/shared/health-fold.d.ts +51 -0
  156. package/dist/domain/shared/health-fold.js +105 -0
  157. package/dist/domain/shared/health-fold.js.map +1 -0
  158. package/dist/domain/shared/health-read.d.ts +35 -0
  159. package/dist/domain/shared/health-read.js +113 -0
  160. package/dist/domain/shared/health-read.js.map +1 -0
  161. package/dist/domain/shared/health-snapshot.d.ts +222 -0
  162. package/dist/domain/shared/health-snapshot.js +204 -0
  163. package/dist/domain/shared/health-snapshot.js.map +1 -0
  164. package/dist/domain/shared/health.d.ts +3 -13
  165. package/dist/domain/shared/health.js +6 -15
  166. package/dist/domain/shared/health.js.map +1 -1
  167. package/dist/domain/shared/history.d.ts +35 -10
  168. package/dist/domain/shared/history.js.map +1 -1
  169. package/dist/domain/shared/page.d.ts +24 -0
  170. package/dist/domain/shared/page.js +10 -0
  171. package/dist/domain/shared/page.js.map +1 -0
  172. package/dist/domain/shared/read-acknowledged.d.ts +19 -0
  173. package/dist/domain/shared/read-acknowledged.js +19 -0
  174. package/dist/domain/shared/read-acknowledged.js.map +1 -0
  175. package/dist/domain/shared/read-fleet-limits.d.ts +2 -2
  176. package/dist/domain/shared/read-fleet-limits.js +1 -1
  177. package/dist/domain/shared/read-fleet-limits.js.map +1 -1
  178. package/dist/domain/shared/read-health.d.ts +4 -2
  179. package/dist/domain/shared/read-health.js +3 -5
  180. package/dist/domain/shared/read-health.js.map +1 -1
  181. package/dist/domain/shared/read-inbox-message.d.ts +21 -0
  182. package/dist/domain/shared/read-inbox-message.js +21 -0
  183. package/dist/domain/shared/read-inbox-message.js.map +1 -0
  184. package/dist/domain/shared/read-inbox-withdrawals.d.ts +22 -0
  185. package/dist/domain/shared/read-inbox-withdrawals.js +20 -0
  186. package/dist/domain/shared/read-inbox-withdrawals.js.map +1 -0
  187. package/dist/domain/shared/read-inbox.d.ts +18 -3
  188. package/dist/domain/shared/read-inbox.js +24 -10
  189. package/dist/domain/shared/read-inbox.js.map +1 -1
  190. package/dist/domain/shared/read-needs-attention.d.ts +16 -7
  191. package/dist/domain/shared/read-needs-attention.js +14 -8
  192. package/dist/domain/shared/read-needs-attention.js.map +1 -1
  193. package/dist/domain/shared/read-ship-messages.d.ts +7 -6
  194. package/dist/domain/shared/read-ship-messages.js +18 -16
  195. package/dist/domain/shared/read-ship-messages.js.map +1 -1
  196. package/dist/domain/shared/read-ship-timeline.d.ts +6 -5
  197. package/dist/domain/shared/read-ship-timeline.js +6 -7
  198. package/dist/domain/shared/read-ship-timeline.js.map +1 -1
  199. package/dist/domain/shared/read-stuck-count.d.ts +23 -0
  200. package/dist/domain/shared/read-stuck-count.js +20 -0
  201. package/dist/domain/shared/read-stuck-count.js.map +1 -0
  202. package/dist/domain/shared/read-stuck-history.d.ts +21 -0
  203. package/dist/domain/shared/read-stuck-history.js +18 -0
  204. package/dist/domain/shared/read-stuck-history.js.map +1 -0
  205. package/dist/domain/shared/read-stuck-summary.d.ts +44 -0
  206. package/dist/domain/shared/read-stuck-summary.js +44 -0
  207. package/dist/domain/shared/read-stuck-summary.js.map +1 -0
  208. package/dist/domain/shared/read-stuck.d.ts +41 -0
  209. package/dist/domain/shared/read-stuck.js +43 -0
  210. package/dist/domain/shared/read-stuck.js.map +1 -0
  211. package/dist/domain/shared/stuck.d.ts +4 -1
  212. package/dist/domain/shared/stuck.js +4 -2
  213. package/dist/domain/shared/stuck.js.map +1 -1
  214. package/dist/domain/shared/wait-buckets.d.ts +15 -0
  215. package/dist/domain/shared/wait-buckets.js +54 -0
  216. package/dist/domain/shared/wait-buckets.js.map +1 -0
  217. package/dist/start.d.ts +2 -1
  218. package/dist/start.js +8 -2
  219. package/dist/start.js.map +1 -1
  220. package/dist/wiring.d.ts +31 -1
  221. package/dist/wiring.js +40 -5
  222. package/dist/wiring.js.map +1 -1
  223. package/package.json +10 -2
  224. package/src/adapters/prisma/migrations/20261022130000_message_days/migration.sql +20 -0
  225. package/src/adapters/prisma/migrations/20261022130100_messages_fleet_time_index/migration.sql +3 -0
  226. package/src/adapters/prisma/migrations/20261022140000_health_snapshots/migration.sql +41 -0
  227. package/src/adapters/prisma/migrations/20261023090000_timeline_page_indexes/migration.sql +7 -0
  228. package/src/adapters/prisma/migrations/20261023090100_messages_page_indexes/migration.sql +7 -0
  229. package/src/adapters/prisma/migrations/20261023090200_inbox_page_index/migration.sql +3 -0
  230. package/src/adapters/prisma/migrations/20261023090300_reach_refusals_page_index/migration.sql +4 -0
  231. package/src/adapters/prisma/migrations/20261023090400_messages_question_id_index/migration.sql +5 -0
  232. package/src/adapters/prisma/migrations/20261023210000_health_snapshot_acknowledged_waits/migration.sql +15 -0
  233. package/src/adapters/prisma/migrations/20261024090000_ship_listing_indexes/migration.sql +13 -0
  234. package/src/adapters/prisma/migrations/20261024120000_ship_listing_every_status_indexes/migration.sql +5 -0
  235. package/src/adapters/prisma/migrations/20261024150000_ship_kind_listing_index/migration.sql +2 -0
  236. package/src/adapters/prisma/schema.prisma +88 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aeolus-fleet/core",
3
- "version": "0.29.2",
3
+ "version": "0.30.1",
4
4
  "description": "The Aeolus fleet server: ships, guaranteed delivery and the API for Claude Code, Codex and any agent.",
5
5
  "keywords": [
6
6
  "ai-agents",
@@ -59,11 +59,19 @@
59
59
  "postpack": "rm LICENSE"
60
60
  },
61
61
  "dependencies": {
62
- "@aeolus-fleet/common": "0.29.2",
62
+ "@aeolus-fleet/common": "0.30.1",
63
63
  "@fastify/websocket": "^11.3.1",
64
64
  "@modelcontextprotocol/server": "^2.3.0",
65
+ "@opentelemetry/api": "^1.9.1",
66
+ "@opentelemetry/exporter-trace-otlp-grpc": "^0.223.0",
67
+ "@opentelemetry/exporter-trace-otlp-http": "^0.223.0",
68
+ "@opentelemetry/exporter-trace-otlp-proto": "^0.223.0",
69
+ "@opentelemetry/sdk-metrics": "^2.12.0",
70
+ "@opentelemetry/sdk-node": "^0.223.0",
71
+ "@opentelemetry/sdk-trace-base": "^2.12.0",
65
72
  "@prisma/adapter-pg": "^7.10.0",
66
73
  "@prisma/client": "^7.10.0",
74
+ "@prisma/instrumentation": "^7.10.1",
67
75
  "@scalar/fastify-api-reference": "^1.72.4",
68
76
  "@trpc/server": "^11.19.0",
69
77
  "fastify": "^5.12.5",
@@ -0,0 +1,20 @@
1
+ -- The messages per fleet and UTC day (performance design, decision 1): a row
2
+ -- per fleet and day with its messages and their payloads' UTF-8 bytes, added to
3
+ -- by each send, so storage and the daily counts no longer scan the messages.
4
+ -- Every message stored before this migration is counted into it once.
5
+ CREATE TABLE "message_days" (
6
+ "fleet_id" TEXT NOT NULL,
7
+ "day" DATE NOT NULL,
8
+ "messages" INTEGER NOT NULL,
9
+ "payload_bytes" BIGINT NOT NULL,
10
+
11
+ CONSTRAINT "message_days_pkey" PRIMARY KEY ("fleet_id", "day")
12
+ );
13
+
14
+ ALTER TABLE "message_days" ADD CONSTRAINT "message_days_fleet_id_fkey" FOREIGN KEY ("fleet_id") REFERENCES "fleets"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
15
+
16
+ -- A payload's UTF-8 bytes, whatever the database encoding.
17
+ INSERT INTO "message_days" ("fleet_id", "day", "messages", "payload_bytes")
18
+ SELECT "fleet_id", ("created_at" AT TIME ZONE 'UTC')::date, count(*), coalesce(sum(octet_length(convert_to("payload", 'UTF8'))), 0)
19
+ FROM "messages"
20
+ GROUP BY 1, 2;
@@ -0,0 +1,3 @@
1
+ -- The installation counts a fleet's messages of the last 7 days through an
2
+ -- index on fleet and time, not by reading every message it stored (#1126).
3
+ CREATE INDEX "messages_fleet_id_created_at_idx" ON "messages"("fleet_id", "created_at");
@@ -0,0 +1,41 @@
1
+ -- The stuck snapshot (docs/design/performance/performance.md, section 5): one
2
+ -- row per fleet and closed hour, and the fleet's open deliveries as of its
3
+ -- latest. The 30 second pass writes them; until a fleet's first pass the
4
+ -- health reads replay its events as before.
5
+ CREATE TABLE "health_snapshots" (
6
+ "fleet_id" TEXT NOT NULL,
7
+ "hour" TIMESTAMPTZ(3) NOT NULL,
8
+ "seq" BIGINT NOT NULL,
9
+ "stuck" JSONB NOT NULL,
10
+ "acknowledged" JSONB NOT NULL,
11
+ "turns" JSONB NOT NULL,
12
+
13
+ CONSTRAINT "health_snapshots_pkey" PRIMARY KEY ("fleet_id", "hour")
14
+ );
15
+
16
+ CREATE TABLE "health_snapshot_deliveries" (
17
+ "fleet_id" TEXT NOT NULL,
18
+ "delivery_id" TEXT NOT NULL,
19
+ "message_id" TEXT NOT NULL,
20
+ "sender_ship_id" TEXT NOT NULL,
21
+ "recipient_ship_id" TEXT,
22
+ "recipient_type" TEXT,
23
+ "claimed_by_ship_id" TEXT,
24
+ "reachable_ship_ids" TEXT[],
25
+ "sent_at" TIMESTAMPTZ(3) NOT NULL,
26
+ "state" "delivery_state",
27
+ "since" TIMESTAMPTZ(3),
28
+ "step_ship_id" TEXT,
29
+ "lease_id" TEXT,
30
+
31
+ CONSTRAINT "health_snapshot_deliveries_pkey" PRIMARY KEY ("fleet_id", "delivery_id")
32
+ );
33
+
34
+ ALTER TABLE "health_snapshots" ADD CONSTRAINT "health_snapshots_fleet_id_fkey" FOREIGN KEY ("fleet_id") REFERENCES "fleets"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
35
+
36
+ ALTER TABLE "health_snapshot_deliveries" ADD CONSTRAINT "health_snapshot_deliveries_fleet_id_fkey" FOREIGN KEY ("fleet_id") REFERENCES "fleets"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
37
+
38
+ -- A first snapshot reads each lease's turn at its oldest hour from the turn
39
+ -- reports alone, not every event of the fleet back to them.
40
+ CREATE INDEX "events_turn_reported_idx" ON "events"("fleet_id", "occurred_at")
41
+ WHERE type = 'TurnReported';
@@ -0,0 +1,7 @@
1
+ -- A ship's timeline pages through the events naming it and the events it
2
+ -- caused by their place in the stream: each index ends with seq, so a page
3
+ -- reads its rows in order instead of every event of the ship.
4
+ DROP INDEX "events_fleet_id_actor_ship_id_idx";
5
+ DROP INDEX "events_fleet_id_ship_id_idx";
6
+ CREATE INDEX "events_fleet_id_actor_ship_id_seq_idx" ON "events"("fleet_id", "actor_ship_id", "seq");
7
+ CREATE INDEX "events_fleet_id_ship_id_seq_idx" ON "events"("fleet_id", "ship_id", "seq");
@@ -0,0 +1,7 @@
1
+ -- A ship's messages page newest first by id: those it sent, those sent to
2
+ -- it, and those it claimed as a ship of their type, each through an index
3
+ -- that reads them in that order instead of every message of the ship.
4
+ DROP INDEX "messages_fleet_id_selector_ship_id_idx";
5
+ CREATE INDEX "messages_fleet_id_selector_ship_id_id_idx" ON "messages"("fleet_id", "selector_ship_id", "id");
6
+ CREATE INDEX "messages_fleet_id_sender_ship_id_id_idx" ON "messages"("fleet_id", "sender_ship_id", "id");
7
+ CREATE INDEX "events_delivery_handed_idx" ON "events"("fleet_id", "ship_id", "message_id") WHERE ("type" = 'DeliveryHanded'::text);
@@ -0,0 +1,3 @@
1
+ -- A ship's inbox pages newest first by delivery id, through an index that
2
+ -- reads its deliveries in that order instead of every one it was sent.
3
+ CREATE INDEX "deliveries_fleet_id_recipient_ship_id_id_idx" ON "deliveries"("fleet_id", "recipient_ship_id", "id");
@@ -0,0 +1,4 @@
1
+ -- The reach refusals page newest first by id, through an index that reads
2
+ -- them in that order.
3
+ DROP INDEX "reach_refusals_fleet_id_at_idx";
4
+ CREATE INDEX "reach_refusals_fleet_id_id_idx" ON "reach_refusals"("fleet_id", "id");
@@ -0,0 +1,5 @@
1
+ -- A question's withdrawals and replacements to argo are found by the question
2
+ -- id they name (decision 0038), read from the payload by this expression,
3
+ -- which never fails on a payload that is not JSON. Only messages whose
4
+ -- content type is one of the question family are indexed.
5
+ CREATE INDEX "messages_question_id_idx" ON "messages"("fleet_id", (substring("payload" from '"questionId"\s*:\s*"([^"]*)"'))) WHERE lower("content_type") LIKE 'application/vnd.aeolus.question-%';
@@ -0,0 +1,15 @@
1
+ -- Each closed hour's acknowledged waits summed over every message
2
+ -- (docs/design/performance/performance.md, decision 10), so a reader of every
3
+ -- ship reads 24 small sums instead of every message's waits. The hours
4
+ -- already closed are summed here from their waits by message.
5
+ ALTER TABLE "health_snapshots" ADD COLUMN "acknowledged_waits" JSONB;
6
+
7
+ UPDATE "health_snapshots" s SET "acknowledged_waits" = COALESCE((
8
+ SELECT jsonb_agg(jsonb_build_array(bucket, count) ORDER BY bucket) FROM (
9
+ SELECT (w->>0)::int AS bucket, sum((w->>1)::int)::int AS count
10
+ FROM jsonb_array_elements(s."acknowledged") a, jsonb_array_elements(a->'waits') w
11
+ GROUP BY 1
12
+ ) summed
13
+ ), '[]'::jsonb);
14
+
15
+ ALTER TABLE "health_snapshots" ALTER COLUMN "acknowledged_waits" SET NOT NULL;
@@ -0,0 +1,13 @@
1
+ -- The fleet snapshot pages its active ships by keyset (decision 4 of the
2
+ -- performance design): in the default order, argo first and then by name,
3
+ -- and sorted by ship, a page reads its own ships from where the cursor
4
+ -- points, never every ship before it. Each key is the listing's order term
5
+ -- as the statement writes it, in its collation.
6
+ CREATE INDEX "ships_listing_idx" ON "ships"("fleet_id", (kind <> 'operator'::ship_kind), (lower("name")) COLLATE "C", "id" COLLATE "C")
7
+ WHERE "retired_at" IS NULL;
8
+ CREATE INDEX "ships_name_listing_idx" ON "ships"("fleet_id", (lower("name")) COLLATE "C", "id" COLLATE "C")
9
+ WHERE "retired_at" IS NULL;
10
+ -- The overview's Type filter reads the distinct types of the active ships
11
+ -- from this index alone.
12
+ CREATE INDEX "ships_type_listing_idx" ON "ships"("fleet_id", "type")
13
+ WHERE "retired_at" IS NULL;
@@ -0,0 +1,5 @@
1
+ -- The fleet snapshot with the retired ships asked pages every ship by
2
+ -- keyset, in the default order and sorted by ship, as the active-only
3
+ -- listing indexes do for the active ones.
4
+ CREATE INDEX "ships_listing_every_status_idx" ON "ships"("fleet_id", (kind <> 'operator'::ship_kind), (lower("name")) COLLATE "C", "id" COLLATE "C");
5
+ CREATE INDEX "ships_name_listing_every_status_idx" ON "ships"("fleet_id", (lower("name")) COLLATE "C", "id" COLLATE "C");
@@ -0,0 +1,2 @@
1
+ -- fleet.list's shipKind filter (performance S6): the few active ships of a kind, such as argo and the person ships, without reading every ship.
2
+ CREATE INDEX "ships_kind_listing_idx" ON "ships"("fleet_id", "kind") WHERE ("retired_at" IS NULL);
@@ -60,6 +60,7 @@ model Fleet {
60
60
  reachRefusals ReachRefusal[]
61
61
  credentials Credential[]
62
62
  messages Message[]
63
+ messageDays MessageDay[]
63
64
  deliveries Delivery[]
64
65
  overdueDeliveries OverdueDelivery[]
65
66
  events Event[]
@@ -70,6 +71,8 @@ model Fleet {
70
71
  accountNoticeDismissals AccountNoticeDismissal[]
71
72
  accountGuideProgress AccountGuideProgress[]
72
73
  operator Operator?
74
+ healthSnapshots HealthSnapshot[]
75
+ healthSnapshotDeliveries HealthSnapshotDelivery[]
73
76
 
74
77
  @@map("fleets")
75
78
  }
@@ -143,6 +146,8 @@ model Ship {
143
146
  /// At most one viewer ship per fleet (decision 0022).
144
147
  @@unique([fleetId], map: "ships_fleet_id_viewer_key", where: raw("kind = 'viewer'::ship_kind"))
145
148
  @@index([fleetId, ownerShipId])
149
+ @@index([fleetId, type], map: "ships_type_listing_idx", where: { retiredAt: null })
150
+ @@index([fleetId, kind], map: "ships_kind_listing_idx", where: { retiredAt: null })
146
151
  @@map("ships")
147
152
  }
148
153
 
@@ -497,8 +502,8 @@ model ReachRefusal {
497
502
 
498
503
  fleet Fleet @relation(fields: [fleetId], references: [id])
499
504
 
500
- /// argo reads the latest first.
501
- @@index([fleetId, at])
505
+ /// They page newest first by id.
506
+ @@index([fleetId, id])
502
507
  @@map("reach_refusals")
503
508
  }
504
509
 
@@ -533,6 +538,23 @@ enum SelectorKind {
533
538
  @@map("selector_kind")
534
539
  }
535
540
 
541
+ /// The messages a fleet stored on one UTC day and their payloads' UTF-8 bytes
542
+ /// (performance design, decision 1). A unit of work adds to it as its last
543
+ /// statements, after the fleet's event numbers, so the row lock is held only
544
+ /// until commit. Storage is the sum of the days; the daily message limit
545
+ /// counts today's row.
546
+ model MessageDay {
547
+ fleetId String @map("fleet_id")
548
+ day DateTime @db.Date
549
+ messages Int
550
+ payloadBytes BigInt @map("payload_bytes")
551
+
552
+ fleet Fleet @relation(fields: [fleetId], references: [id])
553
+
554
+ @@id([fleetId, day])
555
+ @@map("message_days")
556
+ }
557
+
536
558
  /// An immutable envelope plus an opaque payload of at most 64 KB, sent by one ship.
537
559
  /// Ids start with msg_. The selector is stored as resolved at send time: a ship's
538
560
  /// id, never its name, or a type. It can name the message it replies to, and a
@@ -570,9 +592,13 @@ model Message {
570
592
  @@unique([fleetId, senderShipId, idempotencyKey])
571
593
  /// A ship's current model is its newest message with a model.
572
594
  @@index([fleetId, senderShipId, createdAt])
595
+ /// A ship's messages page newest first by id: those it sent and those sent to it.
596
+ @@index([fleetId, senderShipId, id])
597
+ /// The installation counts a fleet's messages of the last 7 days (#1126).
598
+ @@index([fleetId, createdAt])
573
599
  /// Every foreign key has an index leading with its columns, so deleting a
574
600
  /// referenced row checks it with an index, not a scan (#331).
575
- @@index([fleetId, selectorShipId])
601
+ @@index([fleetId, selectorShipId, id])
576
602
  @@index([fleetId, inReplyToMessageId])
577
603
  @@index([fleetId, resendOfMessageId])
578
604
  @@index([fleetId, selectorShipId, createdAt, id], map: "messages_pings_idx", where: raw("(content_type = 'application/vnd.aeolus.ping'::text)"))
@@ -635,6 +661,8 @@ model Delivery {
635
661
  @@unique([messageId, recipientShipId])
636
662
  @@unique([messageId, recipientType])
637
663
  @@index([fleetId, recipientShipId, state])
664
+ /// A ship's inbox pages newest first by id.
665
+ @@index([fleetId, recipientShipId, id])
638
666
  @@index([fleetId, recipientType, state])
639
667
  /// The installation's health figures scan a fleet's open deliveries by state (decision 0041). Partial, so a foreign key check never picks it.
640
668
  @@index([fleetId, state, createdAt], map: "deliveries_open_fleet_id_state_created_at_idx", where: raw("(state = ANY (ARRAY['pending'::delivery_state, 'received'::delivery_state, 'handed'::delivery_state, 'undeliverable'::delivery_state, 'notHandled'::delivery_state]))"))
@@ -682,6 +710,55 @@ model OverdueDelivery {
682
710
  @@map("overdue_deliveries")
683
711
  }
684
712
 
713
+ /// The stuck snapshot (docs/design/performance/performance.md, section 5):
714
+ /// one row per fleet and closed hour, written once by the 30 second pass and
715
+ /// kept for 168 hours. Its counts are by message parties, so a read counts
716
+ /// only what its caller reads (decision 0034).
717
+ model HealthSnapshot {
718
+ fleetId String @map("fleet_id")
719
+ hour DateTime @db.Timestamptz(3)
720
+ /// The last event folded into it, by its seq.
721
+ seq BigInt
722
+ /// Stuck at the hour mark: cause, place, message parties, count and oldest since, each.
723
+ stuck Json
724
+ /// The waits from send to acknowledgement in the hour, by message parties, as counts per duration bucket.
725
+ acknowledged Json
726
+ /// The same waits summed over every message, as a reader of every ship reads them.
727
+ acknowledgedWaits Json @map("acknowledged_waits")
728
+ /// Each lease's latest turn as of seq; the latest row's is the fold's.
729
+ turns Json
730
+
731
+ fleet Fleet @relation(fields: [fleetId], references: [id])
732
+
733
+ @@id([fleetId, hour])
734
+ @@map("health_snapshots")
735
+ }
736
+
737
+ /// The fleet's open deliveries as of its latest snapshot, each at its latest
738
+ /// step: replaced whole by each close. A copy for the fold, so no foreign key
739
+ /// but the fleet's.
740
+ model HealthSnapshotDelivery {
741
+ fleetId String @map("fleet_id")
742
+ deliveryId String @map("delivery_id")
743
+ messageId String @map("message_id")
744
+ senderShipId String @map("sender_ship_id")
745
+ recipientShipId String? @map("recipient_ship_id")
746
+ recipientType String? @map("recipient_type")
747
+ claimedByShipId String? @map("claimed_by_ship_id")
748
+ reachableShipIds String[] @map("reachable_ship_ids")
749
+ sentAt DateTime @map("sent_at") @db.Timestamptz(3)
750
+ /// Its latest step: the state, since when, and the ship and lease that took it; none while pending since its send.
751
+ state DeliveryState?
752
+ since DateTime? @db.Timestamptz(3)
753
+ stepShipId String? @map("step_ship_id")
754
+ leaseId String? @map("lease_id")
755
+
756
+ fleet Fleet @relation(fields: [fleetId], references: [id])
757
+
758
+ @@id([fleetId, deliveryId])
759
+ @@map("health_snapshot_deliveries")
760
+ }
761
+
685
762
  /// Append-only log of every state change: never updated or deleted. Ids start with evt_.
686
763
  /// Records its type and time, who caused it (a ship, or the system when
687
764
  /// actor_ship_id is null), the ship, message and delivery it concerns, and a few
@@ -719,14 +796,20 @@ model Event {
719
796
  @@unique([fleetId, seq])
720
797
  /// Every foreign key has an index leading with its columns, so deleting a
721
798
  /// referenced row checks it with an index, not a scan (#331).
722
- @@index([fleetId, actorShipId])
799
+ /// A ship's timeline pages through the events it caused and those naming
800
+ /// it by their place in the stream, each through its own index.
801
+ @@index([fleetId, actorShipId, seq])
723
802
  @@index([actorThroughShipId, fleetId])
724
- @@index([fleetId, shipId])
803
+ @@index([fleetId, shipId, seq])
725
804
  @@index([fleetId, messageId])
726
805
  @@index([fleetId, deliveryId])
727
806
  /// The health reads take a fleet's events since a time (decision 0042).
728
807
  @@index([fleetId, occurredAt])
729
808
  @@index([fleetId, shipId, seq], map: "events_starting_prompt_issued_idx", where: raw("(type = 'StartingPromptIssued'::text)"))
809
+ /// A ship's messages page through those it claimed as a ship of their type by id.
810
+ @@index([fleetId, shipId, messageId], map: "events_delivery_handed_idx", where: raw("(type = 'DeliveryHanded'::text)"))
811
+ /// A first stuck snapshot reads each lease's turn at its oldest hour from the turn reports alone.
812
+ @@index([fleetId, occurredAt], map: "events_turn_reported_idx", where: raw("(type = 'TurnReported'::text)"))
730
813
  @@map("events")
731
814
  }
732
815