@herdctl/core 0.0.1 → 0.1.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 (284) hide show
  1. package/dist/config/__tests__/agent.test.js +61 -13
  2. package/dist/config/__tests__/agent.test.js.map +1 -1
  3. package/dist/config/__tests__/merge.test.js +10 -3
  4. package/dist/config/__tests__/merge.test.js.map +1 -1
  5. package/dist/config/__tests__/schema.test.js +350 -1
  6. package/dist/config/__tests__/schema.test.js.map +1 -1
  7. package/dist/config/index.d.ts +1 -1
  8. package/dist/config/index.d.ts.map +1 -1
  9. package/dist/config/index.js +3 -1
  10. package/dist/config/index.js.map +1 -1
  11. package/dist/config/schema.d.ts +841 -27
  12. package/dist/config/schema.d.ts.map +1 -1
  13. package/dist/config/schema.js +129 -10
  14. package/dist/config/schema.js.map +1 -1
  15. package/dist/fleet-manager/__tests__/coverage.test.js +14 -331
  16. package/dist/fleet-manager/__tests__/coverage.test.js.map +1 -1
  17. package/dist/fleet-manager/__tests__/errors.test.js +1 -49
  18. package/dist/fleet-manager/__tests__/errors.test.js.map +1 -1
  19. package/dist/fleet-manager/__tests__/integration.test.js +114 -0
  20. package/dist/fleet-manager/__tests__/integration.test.js.map +1 -1
  21. package/dist/fleet-manager/__tests__/job-control.test.js +13 -14
  22. package/dist/fleet-manager/__tests__/job-control.test.js.map +1 -1
  23. package/dist/fleet-manager/__tests__/reload.test.js +12 -2
  24. package/dist/fleet-manager/__tests__/reload.test.js.map +1 -1
  25. package/dist/fleet-manager/__tests__/status-queries.test.js +6 -0
  26. package/dist/fleet-manager/__tests__/status-queries.test.js.map +1 -1
  27. package/dist/fleet-manager/__tests__/trigger.test.js +10 -2
  28. package/dist/fleet-manager/__tests__/trigger.test.js.map +1 -1
  29. package/dist/fleet-manager/config-reload.d.ts +164 -0
  30. package/dist/fleet-manager/config-reload.d.ts.map +1 -0
  31. package/dist/fleet-manager/config-reload.js +445 -0
  32. package/dist/fleet-manager/config-reload.js.map +1 -0
  33. package/dist/fleet-manager/context.d.ts +76 -0
  34. package/dist/fleet-manager/context.d.ts.map +1 -0
  35. package/dist/fleet-manager/context.js +11 -0
  36. package/dist/fleet-manager/context.js.map +1 -0
  37. package/dist/fleet-manager/errors.d.ts +0 -25
  38. package/dist/fleet-manager/errors.d.ts.map +1 -1
  39. package/dist/fleet-manager/errors.js +0 -38
  40. package/dist/fleet-manager/errors.js.map +1 -1
  41. package/dist/fleet-manager/event-emitters.d.ts +123 -0
  42. package/dist/fleet-manager/event-emitters.d.ts.map +1 -0
  43. package/dist/fleet-manager/event-emitters.js +136 -0
  44. package/dist/fleet-manager/event-emitters.js.map +1 -0
  45. package/dist/fleet-manager/event-types.d.ts +0 -15
  46. package/dist/fleet-manager/event-types.d.ts.map +1 -1
  47. package/dist/fleet-manager/fleet-manager.d.ts +40 -653
  48. package/dist/fleet-manager/fleet-manager.d.ts.map +1 -1
  49. package/dist/fleet-manager/fleet-manager.js +95 -1720
  50. package/dist/fleet-manager/fleet-manager.js.map +1 -1
  51. package/dist/fleet-manager/index.d.ts +13 -2
  52. package/dist/fleet-manager/index.d.ts.map +1 -1
  53. package/dist/fleet-manager/index.js +19 -6
  54. package/dist/fleet-manager/index.js.map +1 -1
  55. package/dist/fleet-manager/job-control.d.ts +67 -0
  56. package/dist/fleet-manager/job-control.d.ts.map +1 -0
  57. package/dist/fleet-manager/job-control.js +333 -0
  58. package/dist/fleet-manager/job-control.js.map +1 -0
  59. package/dist/fleet-manager/log-streaming.d.ts +171 -0
  60. package/dist/fleet-manager/log-streaming.d.ts.map +1 -0
  61. package/dist/fleet-manager/log-streaming.js +503 -0
  62. package/dist/fleet-manager/log-streaming.js.map +1 -0
  63. package/dist/fleet-manager/schedule-executor.d.ts +63 -0
  64. package/dist/fleet-manager/schedule-executor.d.ts.map +1 -0
  65. package/dist/fleet-manager/schedule-executor.js +209 -0
  66. package/dist/fleet-manager/schedule-executor.js.map +1 -0
  67. package/dist/fleet-manager/schedule-management.d.ts +71 -0
  68. package/dist/fleet-manager/schedule-management.d.ts.map +1 -0
  69. package/dist/fleet-manager/schedule-management.js +171 -0
  70. package/dist/fleet-manager/schedule-management.js.map +1 -0
  71. package/dist/fleet-manager/status-queries.d.ts +105 -0
  72. package/dist/fleet-manager/status-queries.d.ts.map +1 -0
  73. package/dist/fleet-manager/status-queries.js +247 -0
  74. package/dist/fleet-manager/status-queries.js.map +1 -0
  75. package/dist/fleet-manager/types.d.ts +0 -39
  76. package/dist/fleet-manager/types.d.ts.map +1 -1
  77. package/dist/runner/__tests__/job-executor.test.js +206 -1
  78. package/dist/runner/__tests__/job-executor.test.js.map +1 -1
  79. package/dist/runner/job-executor.d.ts +9 -0
  80. package/dist/runner/job-executor.d.ts.map +1 -1
  81. package/dist/runner/job-executor.js +78 -4
  82. package/dist/runner/job-executor.js.map +1 -1
  83. package/dist/runner/message-processor.d.ts.map +1 -1
  84. package/dist/runner/message-processor.js +53 -0
  85. package/dist/runner/message-processor.js.map +1 -1
  86. package/dist/runner/types.d.ts +3 -1
  87. package/dist/runner/types.d.ts.map +1 -1
  88. package/dist/scheduler/__tests__/cron.test.d.ts +2 -0
  89. package/dist/scheduler/__tests__/cron.test.d.ts.map +1 -0
  90. package/dist/scheduler/__tests__/cron.test.js +867 -0
  91. package/dist/scheduler/__tests__/cron.test.js.map +1 -0
  92. package/dist/scheduler/__tests__/scheduler.test.js +164 -5
  93. package/dist/scheduler/__tests__/scheduler.test.js.map +1 -1
  94. package/dist/scheduler/cron.d.ts +126 -0
  95. package/dist/scheduler/cron.d.ts.map +1 -0
  96. package/dist/scheduler/cron.js +390 -0
  97. package/dist/scheduler/cron.js.map +1 -0
  98. package/dist/scheduler/errors.d.ts +81 -1
  99. package/dist/scheduler/errors.d.ts.map +1 -1
  100. package/dist/scheduler/errors.js +81 -6
  101. package/dist/scheduler/errors.js.map +1 -1
  102. package/dist/scheduler/index.d.ts +1 -0
  103. package/dist/scheduler/index.d.ts.map +1 -1
  104. package/dist/scheduler/index.js +2 -0
  105. package/dist/scheduler/index.js.map +1 -1
  106. package/dist/scheduler/schedule-runner.d.ts +2 -2
  107. package/dist/scheduler/schedule-runner.d.ts.map +1 -1
  108. package/dist/scheduler/schedule-runner.js +20 -8
  109. package/dist/scheduler/schedule-runner.js.map +1 -1
  110. package/dist/scheduler/scheduler.d.ts +4 -4
  111. package/dist/scheduler/scheduler.d.ts.map +1 -1
  112. package/dist/scheduler/scheduler.js +95 -20
  113. package/dist/scheduler/scheduler.js.map +1 -1
  114. package/dist/scheduler/types.d.ts +1 -1
  115. package/dist/scheduler/types.d.ts.map +1 -1
  116. package/dist/state/schemas/job-metadata.d.ts +2 -2
  117. package/package.json +33 -8
  118. package/.turbo/turbo-build.log +0 -4
  119. package/.turbo/turbo-test.log +0 -219
  120. package/.turbo/turbo-typecheck.log +0 -4
  121. package/coverage/base.css +0 -224
  122. package/coverage/block-navigation.js +0 -87
  123. package/coverage/coverage-final.json +0 -51
  124. package/coverage/favicon.png +0 -0
  125. package/coverage/index.html +0 -251
  126. package/coverage/prettify.css +0 -1
  127. package/coverage/prettify.js +0 -2
  128. package/coverage/sort-arrow-sprite.png +0 -0
  129. package/coverage/sorter.js +0 -210
  130. package/coverage/src/config/index.html +0 -191
  131. package/coverage/src/config/index.ts.html +0 -442
  132. package/coverage/src/config/interpolate.ts.html +0 -652
  133. package/coverage/src/config/loader.ts.html +0 -1501
  134. package/coverage/src/config/merge.ts.html +0 -823
  135. package/coverage/src/config/parser.ts.html +0 -1213
  136. package/coverage/src/config/schema.ts.html +0 -1123
  137. package/coverage/src/fleet-manager/errors.ts.html +0 -2326
  138. package/coverage/src/fleet-manager/event-types.ts.html +0 -1219
  139. package/coverage/src/fleet-manager/fleet-manager.ts.html +0 -7030
  140. package/coverage/src/fleet-manager/index.html +0 -206
  141. package/coverage/src/fleet-manager/index.ts.html +0 -469
  142. package/coverage/src/fleet-manager/job-manager.ts.html +0 -2074
  143. package/coverage/src/fleet-manager/job-queue.ts.html +0 -2479
  144. package/coverage/src/fleet-manager/types.ts.html +0 -2602
  145. package/coverage/src/index.html +0 -116
  146. package/coverage/src/index.ts.html +0 -181
  147. package/coverage/src/runner/errors.ts.html +0 -1006
  148. package/coverage/src/runner/index.html +0 -191
  149. package/coverage/src/runner/index.ts.html +0 -256
  150. package/coverage/src/runner/job-executor.ts.html +0 -1429
  151. package/coverage/src/runner/message-processor.ts.html +0 -1150
  152. package/coverage/src/runner/sdk-adapter.ts.html +0 -658
  153. package/coverage/src/runner/types.ts.html +0 -559
  154. package/coverage/src/scheduler/errors.ts.html +0 -388
  155. package/coverage/src/scheduler/index.html +0 -206
  156. package/coverage/src/scheduler/index.ts.html +0 -244
  157. package/coverage/src/scheduler/interval.ts.html +0 -652
  158. package/coverage/src/scheduler/schedule-runner.ts.html +0 -1411
  159. package/coverage/src/scheduler/schedule-state.ts.html +0 -718
  160. package/coverage/src/scheduler/scheduler.ts.html +0 -1795
  161. package/coverage/src/scheduler/types.ts.html +0 -733
  162. package/coverage/src/state/directory.ts.html +0 -736
  163. package/coverage/src/state/errors.ts.html +0 -376
  164. package/coverage/src/state/fleet-state.ts.html +0 -937
  165. package/coverage/src/state/index.html +0 -221
  166. package/coverage/src/state/index.ts.html +0 -322
  167. package/coverage/src/state/job-metadata.ts.html +0 -1420
  168. package/coverage/src/state/job-output.ts.html +0 -1033
  169. package/coverage/src/state/schemas/fleet-state.ts.html +0 -445
  170. package/coverage/src/state/schemas/index.html +0 -176
  171. package/coverage/src/state/schemas/index.ts.html +0 -286
  172. package/coverage/src/state/schemas/job-metadata.ts.html +0 -628
  173. package/coverage/src/state/schemas/job-output.ts.html +0 -616
  174. package/coverage/src/state/schemas/session-info.ts.html +0 -361
  175. package/coverage/src/state/session.ts.html +0 -844
  176. package/coverage/src/state/types.ts.html +0 -262
  177. package/coverage/src/state/utils/atomic.ts.html +0 -748
  178. package/coverage/src/state/utils/index.html +0 -146
  179. package/coverage/src/state/utils/index.ts.html +0 -103
  180. package/coverage/src/state/utils/reads.ts.html +0 -1621
  181. package/coverage/src/work-sources/adapters/github.ts.html +0 -3583
  182. package/coverage/src/work-sources/adapters/index.html +0 -131
  183. package/coverage/src/work-sources/adapters/index.ts.html +0 -277
  184. package/coverage/src/work-sources/errors.ts.html +0 -298
  185. package/coverage/src/work-sources/index.html +0 -176
  186. package/coverage/src/work-sources/index.ts.html +0 -529
  187. package/coverage/src/work-sources/manager.ts.html +0 -1324
  188. package/coverage/src/work-sources/registry.ts.html +0 -619
  189. package/coverage/src/work-sources/types.ts.html +0 -568
  190. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts +0 -7
  191. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts.map +0 -1
  192. package/dist/fleet-manager/__tests__/event-helpers.test.js +0 -368
  193. package/dist/fleet-manager/__tests__/event-helpers.test.js.map +0 -1
  194. package/src/config/__tests__/agent.test.ts +0 -864
  195. package/src/config/__tests__/interpolate.test.ts +0 -644
  196. package/src/config/__tests__/loader.test.ts +0 -784
  197. package/src/config/__tests__/merge.test.ts +0 -751
  198. package/src/config/__tests__/parser.test.ts +0 -533
  199. package/src/config/__tests__/schema.test.ts +0 -873
  200. package/src/config/index.ts +0 -119
  201. package/src/config/interpolate.ts +0 -189
  202. package/src/config/loader.ts +0 -472
  203. package/src/config/merge.ts +0 -246
  204. package/src/config/parser.ts +0 -376
  205. package/src/config/schema.ts +0 -346
  206. package/src/fleet-manager/__tests__/coverage.test.ts +0 -2869
  207. package/src/fleet-manager/__tests__/errors.test.ts +0 -660
  208. package/src/fleet-manager/__tests__/event-helpers.test.ts +0 -448
  209. package/src/fleet-manager/__tests__/integration.test.ts +0 -1209
  210. package/src/fleet-manager/__tests__/job-control.test.ts +0 -283
  211. package/src/fleet-manager/__tests__/job-manager.test.ts +0 -869
  212. package/src/fleet-manager/__tests__/job-queue.test.ts +0 -401
  213. package/src/fleet-manager/__tests__/reload.test.ts +0 -751
  214. package/src/fleet-manager/__tests__/status-queries.test.ts +0 -595
  215. package/src/fleet-manager/__tests__/trigger.test.ts +0 -601
  216. package/src/fleet-manager/errors.ts +0 -747
  217. package/src/fleet-manager/event-types.ts +0 -378
  218. package/src/fleet-manager/fleet-manager.ts +0 -2315
  219. package/src/fleet-manager/index.ts +0 -128
  220. package/src/fleet-manager/job-manager.ts +0 -663
  221. package/src/fleet-manager/job-queue.ts +0 -798
  222. package/src/fleet-manager/types.ts +0 -839
  223. package/src/index.ts +0 -32
  224. package/src/runner/__tests__/errors.test.ts +0 -382
  225. package/src/runner/__tests__/job-executor.test.ts +0 -1708
  226. package/src/runner/__tests__/message-processor.test.ts +0 -960
  227. package/src/runner/__tests__/sdk-adapter.test.ts +0 -626
  228. package/src/runner/errors.ts +0 -307
  229. package/src/runner/index.ts +0 -57
  230. package/src/runner/job-executor.ts +0 -448
  231. package/src/runner/message-processor.ts +0 -355
  232. package/src/runner/sdk-adapter.ts +0 -191
  233. package/src/runner/types.ts +0 -158
  234. package/src/scheduler/__tests__/errors.test.ts +0 -159
  235. package/src/scheduler/__tests__/interval.test.ts +0 -515
  236. package/src/scheduler/__tests__/schedule-runner.test.ts +0 -798
  237. package/src/scheduler/__tests__/schedule-state.test.ts +0 -671
  238. package/src/scheduler/__tests__/scheduler.test.ts +0 -1280
  239. package/src/scheduler/errors.ts +0 -101
  240. package/src/scheduler/index.ts +0 -53
  241. package/src/scheduler/interval.ts +0 -189
  242. package/src/scheduler/schedule-runner.ts +0 -442
  243. package/src/scheduler/schedule-state.ts +0 -211
  244. package/src/scheduler/scheduler.ts +0 -570
  245. package/src/scheduler/types.ts +0 -216
  246. package/src/state/__tests__/directory.test.ts +0 -595
  247. package/src/state/__tests__/fleet-state.test.ts +0 -868
  248. package/src/state/__tests__/job-metadata-schema.test.ts +0 -414
  249. package/src/state/__tests__/job-metadata.test.ts +0 -831
  250. package/src/state/__tests__/job-output.test.ts +0 -856
  251. package/src/state/__tests__/session-schema.test.ts +0 -378
  252. package/src/state/__tests__/session.test.ts +0 -604
  253. package/src/state/directory.ts +0 -217
  254. package/src/state/errors.ts +0 -97
  255. package/src/state/fleet-state.ts +0 -284
  256. package/src/state/index.ts +0 -79
  257. package/src/state/job-metadata.ts +0 -445
  258. package/src/state/job-output.ts +0 -316
  259. package/src/state/schemas/__tests__/job-output.test.ts +0 -338
  260. package/src/state/schemas/fleet-state.ts +0 -120
  261. package/src/state/schemas/index.ts +0 -67
  262. package/src/state/schemas/job-metadata.ts +0 -181
  263. package/src/state/schemas/job-output.ts +0 -177
  264. package/src/state/schemas/session-info.ts +0 -92
  265. package/src/state/session.ts +0 -253
  266. package/src/state/types.ts +0 -59
  267. package/src/state/utils/__tests__/atomic.test.ts +0 -723
  268. package/src/state/utils/__tests__/reads.test.ts +0 -1071
  269. package/src/state/utils/atomic.ts +0 -221
  270. package/src/state/utils/index.ts +0 -6
  271. package/src/state/utils/reads.ts +0 -512
  272. package/src/work-sources/__tests__/github.test.ts +0 -1800
  273. package/src/work-sources/__tests__/manager.test.ts +0 -529
  274. package/src/work-sources/__tests__/registry.test.ts +0 -477
  275. package/src/work-sources/__tests__/types.test.ts +0 -479
  276. package/src/work-sources/adapters/github.ts +0 -1166
  277. package/src/work-sources/adapters/index.ts +0 -64
  278. package/src/work-sources/errors.ts +0 -71
  279. package/src/work-sources/index.ts +0 -148
  280. package/src/work-sources/manager.ts +0 -413
  281. package/src/work-sources/registry.ts +0 -178
  282. package/src/work-sources/types.ts +0 -161
  283. package/tsconfig.json +0 -9
  284. package/vitest.config.ts +0 -19
@@ -1,660 +0,0 @@
1
- /**
2
- * Tests for fleet-manager error classes
3
- *
4
- * Tests all error classes, their constructors, properties, and type guards.
5
- */
6
-
7
- import { describe, it, expect } from "vitest";
8
- import {
9
- FleetManagerErrorCode,
10
- FleetManagerError,
11
- ConfigurationError,
12
- AgentNotFoundError,
13
- JobNotFoundError,
14
- ScheduleNotFoundError,
15
- InvalidStateError,
16
- FleetManagerStateError,
17
- ConcurrencyLimitError,
18
- FleetManagerConfigError,
19
- FleetManagerStateDirError,
20
- FleetManagerShutdownError,
21
- JobCancelError,
22
- JobForkError,
23
- // Type guards
24
- isFleetManagerError,
25
- isConfigurationError,
26
- isAgentNotFoundError,
27
- isJobNotFoundError,
28
- isScheduleNotFoundError,
29
- isInvalidStateError,
30
- isConcurrencyLimitError,
31
- isJobCancelError,
32
- isJobForkError,
33
- } from "../errors.js";
34
-
35
- describe("FleetManagerError classes", () => {
36
- // ===========================================================================
37
- // FleetManagerError (base class)
38
- // ===========================================================================
39
- describe("FleetManagerError", () => {
40
- it("creates error with message", () => {
41
- const error = new FleetManagerError("Test error");
42
- expect(error.message).toBe("Test error");
43
- expect(error.name).toBe("FleetManagerError");
44
- expect(error.code).toBe(FleetManagerErrorCode.FLEET_MANAGER_ERROR);
45
- });
46
-
47
- it("creates error with custom code", () => {
48
- const error = new FleetManagerError("Test error", {
49
- code: FleetManagerErrorCode.CONFIGURATION_ERROR,
50
- });
51
- expect(error.code).toBe(FleetManagerErrorCode.CONFIGURATION_ERROR);
52
- });
53
-
54
- it("creates error with cause", () => {
55
- const cause = new Error("Original error");
56
- const error = new FleetManagerError("Wrapped error", { cause });
57
- expect(error.cause).toBe(cause);
58
- });
59
- });
60
-
61
- // ===========================================================================
62
- // ConfigurationError
63
- // ===========================================================================
64
- describe("ConfigurationError", () => {
65
- it("creates error with message only", () => {
66
- const error = new ConfigurationError("Config failed");
67
- expect(error.message).toContain("Config failed");
68
- expect(error.name).toBe("ConfigurationError");
69
- expect(error.code).toBe(FleetManagerErrorCode.CONFIGURATION_ERROR);
70
- expect(error.configPath).toBeUndefined();
71
- expect(error.validationErrors).toEqual([]);
72
- });
73
-
74
- it("creates error with config path", () => {
75
- const error = new ConfigurationError("Config failed", {
76
- configPath: "/path/to/config.yaml",
77
- });
78
- expect(error.message).toContain("Config failed");
79
- expect(error.message).toContain("/path/to/config.yaml");
80
- expect(error.configPath).toBe("/path/to/config.yaml");
81
- });
82
-
83
- it("creates error with validation errors", () => {
84
- const error = new ConfigurationError("Validation failed", {
85
- validationErrors: [
86
- { path: "agents[0].name", message: "Name is required" },
87
- { path: "agents[0].model", message: "Invalid model", value: "unknown" },
88
- ],
89
- });
90
- expect(error.message).toContain("Validation errors:");
91
- expect(error.message).toContain("agents[0].name");
92
- expect(error.message).toContain("Name is required");
93
- expect(error.validationErrors).toHaveLength(2);
94
- });
95
-
96
- it("hasValidationErrors returns true when errors exist", () => {
97
- const error = new ConfigurationError("Validation failed", {
98
- validationErrors: [{ path: "test", message: "error" }],
99
- });
100
- expect(error.hasValidationErrors()).toBe(true);
101
- });
102
-
103
- it("hasValidationErrors returns false when no errors", () => {
104
- const error = new ConfigurationError("Config failed");
105
- expect(error.hasValidationErrors()).toBe(false);
106
- });
107
-
108
- it("creates error with cause", () => {
109
- const cause = new Error("YAML parse error");
110
- const error = new ConfigurationError("Config failed", { cause });
111
- expect(error.cause).toBe(cause);
112
- });
113
- });
114
-
115
- // ===========================================================================
116
- // AgentNotFoundError
117
- // ===========================================================================
118
- describe("AgentNotFoundError", () => {
119
- it("creates error with agent name", () => {
120
- const error = new AgentNotFoundError("my-agent");
121
- expect(error.message).toContain("my-agent");
122
- expect(error.message).toContain("not found");
123
- expect(error.name).toBe("AgentNotFoundError");
124
- expect(error.code).toBe(FleetManagerErrorCode.AGENT_NOT_FOUND);
125
- expect(error.agentName).toBe("my-agent");
126
- expect(error.availableAgents).toBeUndefined();
127
- });
128
-
129
- it("creates error with available agents list", () => {
130
- const error = new AgentNotFoundError("missing", {
131
- availableAgents: ["agent-a", "agent-b", "agent-c"],
132
- });
133
- expect(error.message).toContain("Available agents:");
134
- expect(error.message).toContain("agent-a");
135
- expect(error.availableAgents).toEqual(["agent-a", "agent-b", "agent-c"]);
136
- });
137
-
138
- it("shows message for empty agents list", () => {
139
- const error = new AgentNotFoundError("missing", {
140
- availableAgents: [],
141
- });
142
- expect(error.message).toContain("No agents are configured");
143
- });
144
-
145
- it("creates error with cause", () => {
146
- const cause = new Error("Lookup failed");
147
- const error = new AgentNotFoundError("my-agent", { cause });
148
- expect(error.cause).toBe(cause);
149
- });
150
- });
151
-
152
- // ===========================================================================
153
- // JobNotFoundError
154
- // ===========================================================================
155
- describe("JobNotFoundError", () => {
156
- it("creates error with job ID", () => {
157
- const error = new JobNotFoundError("job-2024-01-15-abc123");
158
- expect(error.message).toContain("job-2024-01-15-abc123");
159
- expect(error.message).toContain("not found");
160
- expect(error.name).toBe("JobNotFoundError");
161
- expect(error.code).toBe(FleetManagerErrorCode.JOB_NOT_FOUND);
162
- expect(error.jobId).toBe("job-2024-01-15-abc123");
163
- });
164
-
165
- it("creates error with cause", () => {
166
- const cause = new Error("File not found");
167
- const error = new JobNotFoundError("job-123", { cause });
168
- expect(error.cause).toBe(cause);
169
- });
170
- });
171
-
172
- // ===========================================================================
173
- // ScheduleNotFoundError
174
- // ===========================================================================
175
- describe("ScheduleNotFoundError", () => {
176
- it("creates error with agent and schedule names", () => {
177
- const error = new ScheduleNotFoundError("my-agent", "hourly");
178
- expect(error.message).toContain("hourly");
179
- expect(error.message).toContain("my-agent");
180
- expect(error.message).toContain("not found");
181
- expect(error.name).toBe("ScheduleNotFoundError");
182
- expect(error.code).toBe(FleetManagerErrorCode.SCHEDULE_NOT_FOUND);
183
- expect(error.agentName).toBe("my-agent");
184
- expect(error.scheduleName).toBe("hourly");
185
- expect(error.availableSchedules).toBeUndefined();
186
- });
187
-
188
- it("creates error with available schedules list", () => {
189
- const error = new ScheduleNotFoundError("my-agent", "missing", {
190
- availableSchedules: ["hourly", "daily", "weekly"],
191
- });
192
- expect(error.message).toContain("Available schedules:");
193
- expect(error.message).toContain("hourly");
194
- expect(error.availableSchedules).toEqual(["hourly", "daily", "weekly"]);
195
- });
196
-
197
- it("shows message for empty schedules list", () => {
198
- const error = new ScheduleNotFoundError("my-agent", "missing", {
199
- availableSchedules: [],
200
- });
201
- expect(error.message).toContain("has no schedules configured");
202
- });
203
-
204
- it("creates error with cause", () => {
205
- const cause = new Error("Config error");
206
- const error = new ScheduleNotFoundError("agent", "schedule", { cause });
207
- expect(error.cause).toBe(cause);
208
- });
209
- });
210
-
211
- // ===========================================================================
212
- // InvalidStateError
213
- // ===========================================================================
214
- describe("InvalidStateError", () => {
215
- it("creates error with single expected state", () => {
216
- const error = new InvalidStateError("start", "uninitialized", "initialized");
217
- expect(error.message).toContain("Cannot start");
218
- expect(error.message).toContain("uninitialized");
219
- expect(error.message).toContain("initialized");
220
- expect(error.name).toBe("InvalidStateError");
221
- expect(error.code).toBe(FleetManagerErrorCode.INVALID_STATE);
222
- expect(error.operation).toBe("start");
223
- expect(error.currentState).toBe("uninitialized");
224
- expect(error.expectedState).toBe("initialized");
225
- });
226
-
227
- it("creates error with multiple expected states", () => {
228
- const error = new InvalidStateError("reload", "uninitialized", [
229
- "initialized",
230
- "running",
231
- "stopped",
232
- ]);
233
- expect(error.message).toContain("initialized or running or stopped");
234
- expect(error.expectedState).toEqual(["initialized", "running", "stopped"]);
235
- });
236
-
237
- it("creates error with cause", () => {
238
- const cause = new Error("State transition failed");
239
- const error = new InvalidStateError("start", "error", "initialized", { cause });
240
- expect(error.cause).toBe(cause);
241
- });
242
- });
243
-
244
- // ===========================================================================
245
- // FleetManagerStateError (deprecated)
246
- // ===========================================================================
247
- describe("FleetManagerStateError (deprecated)", () => {
248
- it("creates error with operation and states", () => {
249
- const error = new FleetManagerStateError("start", "uninitialized", "initialized");
250
- expect(error.message).toContain("Cannot start");
251
- expect(error.name).toBe("FleetManagerStateError");
252
- expect(error.operation).toBe("start");
253
- expect(error.currentState).toBe("uninitialized");
254
- expect(error.expectedState).toBe("initialized");
255
- });
256
-
257
- it("provides requiredState alias for backwards compatibility", () => {
258
- const error = new FleetManagerStateError("stop", "starting", [
259
- "running",
260
- "initialized",
261
- ]);
262
- expect(error.requiredState).toEqual(["running", "initialized"]);
263
- expect(error.requiredState).toBe(error.expectedState);
264
- });
265
- });
266
-
267
- // ===========================================================================
268
- // ConcurrencyLimitError
269
- // ===========================================================================
270
- describe("ConcurrencyLimitError", () => {
271
- it("creates error with agent name and limits", () => {
272
- const error = new ConcurrencyLimitError("my-agent", 3, 3);
273
- expect(error.message).toContain("my-agent");
274
- expect(error.message).toContain("concurrency limit");
275
- expect(error.message).toContain("3/3");
276
- expect(error.name).toBe("ConcurrencyLimitError");
277
- expect(error.code).toBe(FleetManagerErrorCode.CONCURRENCY_LIMIT);
278
- expect(error.agentName).toBe("my-agent");
279
- expect(error.currentJobs).toBe(3);
280
- expect(error.limit).toBe(3);
281
- });
282
-
283
- it("isAtLimit returns true when at capacity", () => {
284
- const error = new ConcurrencyLimitError("agent", 5, 5);
285
- expect(error.isAtLimit()).toBe(true);
286
- });
287
-
288
- it("isAtLimit returns true when over capacity", () => {
289
- const error = new ConcurrencyLimitError("agent", 6, 5);
290
- expect(error.isAtLimit()).toBe(true);
291
- });
292
-
293
- it("isAtLimit returns false when under capacity", () => {
294
- const error = new ConcurrencyLimitError("agent", 2, 5);
295
- expect(error.isAtLimit()).toBe(false);
296
- });
297
-
298
- it("creates error with cause", () => {
299
- const cause = new Error("Queue full");
300
- const error = new ConcurrencyLimitError("agent", 3, 3, { cause });
301
- expect(error.cause).toBe(cause);
302
- });
303
- });
304
-
305
- // ===========================================================================
306
- // FleetManagerConfigError (deprecated)
307
- // ===========================================================================
308
- describe("FleetManagerConfigError (deprecated)", () => {
309
- it("creates error with message only", () => {
310
- const error = new FleetManagerConfigError("Config not found");
311
- expect(error.message).toBe("Config not found");
312
- expect(error.name).toBe("FleetManagerConfigError");
313
- expect(error.code).toBe(FleetManagerErrorCode.CONFIG_LOAD_ERROR);
314
- expect(error.configPath).toBeUndefined();
315
- });
316
-
317
- it("creates error with config path", () => {
318
- const error = new FleetManagerConfigError(
319
- "Failed to load",
320
- "/path/to/config.yaml"
321
- );
322
- expect(error.configPath).toBe("/path/to/config.yaml");
323
- });
324
-
325
- it("creates error with cause", () => {
326
- const cause = new Error("YAML parse error");
327
- const error = new FleetManagerConfigError("Config invalid", undefined, {
328
- cause,
329
- });
330
- expect(error.cause).toBe(cause);
331
- });
332
- });
333
-
334
- // ===========================================================================
335
- // FleetManagerStateDirError
336
- // ===========================================================================
337
- describe("FleetManagerStateDirError", () => {
338
- it("creates error with message and state directory", () => {
339
- const error = new FleetManagerStateDirError(
340
- "Failed to create directory",
341
- "/path/to/.herdctl"
342
- );
343
- expect(error.message).toBe("Failed to create directory");
344
- expect(error.name).toBe("FleetManagerStateDirError");
345
- expect(error.code).toBe(FleetManagerErrorCode.STATE_DIR_ERROR);
346
- expect(error.stateDir).toBe("/path/to/.herdctl");
347
- });
348
-
349
- it("creates error with cause", () => {
350
- const cause = new Error("Permission denied");
351
- const error = new FleetManagerStateDirError("Access denied", "/tmp/state", {
352
- cause,
353
- });
354
- expect(error.cause).toBe(cause);
355
- });
356
- });
357
-
358
- // ===========================================================================
359
- // FleetManagerShutdownError
360
- // ===========================================================================
361
- describe("FleetManagerShutdownError", () => {
362
- it("creates error with timedOut true", () => {
363
- const error = new FleetManagerShutdownError("Shutdown timed out", {
364
- timedOut: true,
365
- });
366
- expect(error.message).toBe("Shutdown timed out");
367
- expect(error.name).toBe("FleetManagerShutdownError");
368
- expect(error.code).toBe(FleetManagerErrorCode.SHUTDOWN_ERROR);
369
- expect(error.timedOut).toBe(true);
370
- });
371
-
372
- it("creates error with timedOut false", () => {
373
- const error = new FleetManagerShutdownError("Shutdown failed", {
374
- timedOut: false,
375
- });
376
- expect(error.timedOut).toBe(false);
377
- });
378
-
379
- it("isTimeout returns correct value", () => {
380
- const timedOutError = new FleetManagerShutdownError("Timeout", {
381
- timedOut: true,
382
- });
383
- const normalError = new FleetManagerShutdownError("Error", {
384
- timedOut: false,
385
- });
386
-
387
- expect(timedOutError.isTimeout()).toBe(true);
388
- expect(normalError.isTimeout()).toBe(false);
389
- });
390
-
391
- it("creates error with cause", () => {
392
- const cause = new Error("Jobs still running");
393
- const error = new FleetManagerShutdownError("Shutdown failed", {
394
- timedOut: true,
395
- cause,
396
- });
397
- expect(error.cause).toBe(cause);
398
- });
399
- });
400
-
401
- // ===========================================================================
402
- // JobCancelError
403
- // ===========================================================================
404
- describe("JobCancelError", () => {
405
- it("creates error for not_running reason", () => {
406
- const error = new JobCancelError("job-123", "not_running");
407
- expect(error.message).toContain("not running");
408
- expect(error.name).toBe("JobCancelError");
409
- expect(error.code).toBe(FleetManagerErrorCode.JOB_CANCEL_ERROR);
410
- expect(error.jobId).toBe("job-123");
411
- expect(error.reason).toBe("not_running");
412
- });
413
-
414
- it("creates error for process_error reason", () => {
415
- const error = new JobCancelError("job-456", "process_error");
416
- expect(error.message).toContain("Failed to terminate");
417
- expect(error.reason).toBe("process_error");
418
- });
419
-
420
- it("creates error for timeout reason", () => {
421
- const error = new JobCancelError("job-789", "timeout");
422
- expect(error.message).toContain("Timeout");
423
- expect(error.reason).toBe("timeout");
424
- });
425
-
426
- it("creates error for unknown reason", () => {
427
- const error = new JobCancelError("job-abc", "unknown");
428
- expect(error.message).toContain("Unknown error");
429
- expect(error.reason).toBe("unknown");
430
- });
431
-
432
- it("uses custom message when provided", () => {
433
- const error = new JobCancelError("job-123", "process_error", {
434
- message: "Custom cancellation message",
435
- });
436
- expect(error.message).toBe("Custom cancellation message");
437
- });
438
-
439
- it("creates error with cause", () => {
440
- const cause = new Error("SIGKILL failed");
441
- const error = new JobCancelError("job-123", "process_error", { cause });
442
- expect(error.cause).toBe(cause);
443
- });
444
- });
445
-
446
- // ===========================================================================
447
- // JobForkError
448
- // ===========================================================================
449
- describe("JobForkError", () => {
450
- it("creates error for no_session reason", () => {
451
- const error = new JobForkError("job-123", "no_session");
452
- expect(error.message).toContain("no session ID");
453
- expect(error.name).toBe("JobForkError");
454
- expect(error.code).toBe(FleetManagerErrorCode.JOB_FORK_ERROR);
455
- expect(error.originalJobId).toBe("job-123");
456
- expect(error.reason).toBe("no_session");
457
- });
458
-
459
- it("creates error for job_not_found reason", () => {
460
- const error = new JobForkError("job-456", "job_not_found");
461
- expect(error.message).toContain("not found");
462
- expect(error.reason).toBe("job_not_found");
463
- });
464
-
465
- it("creates error for agent_not_found reason", () => {
466
- const error = new JobForkError("job-789", "agent_not_found");
467
- expect(error.message).toContain("Agent");
468
- expect(error.message).toContain("not found");
469
- expect(error.reason).toBe("agent_not_found");
470
- });
471
-
472
- it("creates error for unknown reason", () => {
473
- const error = new JobForkError("job-abc", "unknown");
474
- expect(error.message).toContain("Unknown error");
475
- expect(error.reason).toBe("unknown");
476
- });
477
-
478
- it("uses custom message when provided", () => {
479
- const error = new JobForkError("job-123", "no_session", {
480
- message: "Custom fork error message",
481
- });
482
- expect(error.message).toBe("Custom fork error message");
483
- });
484
-
485
- it("creates error with cause", () => {
486
- const cause = new Error("Session lookup failed");
487
- const error = new JobForkError("job-123", "no_session", { cause });
488
- expect(error.cause).toBe(cause);
489
- });
490
- });
491
-
492
- // ===========================================================================
493
- // Type Guards
494
- // ===========================================================================
495
- describe("Type Guards", () => {
496
- describe("isFleetManagerError", () => {
497
- it("returns true for FleetManagerError", () => {
498
- const error = new FleetManagerError("test");
499
- expect(isFleetManagerError(error)).toBe(true);
500
- });
501
-
502
- it("returns true for all subclasses", () => {
503
- expect(isFleetManagerError(new ConfigurationError("test"))).toBe(true);
504
- expect(isFleetManagerError(new AgentNotFoundError("test"))).toBe(true);
505
- expect(isFleetManagerError(new JobNotFoundError("test"))).toBe(true);
506
- expect(isFleetManagerError(new ScheduleNotFoundError("a", "b"))).toBe(true);
507
- expect(isFleetManagerError(new InvalidStateError("a", "b", "c"))).toBe(true);
508
- expect(isFleetManagerError(new ConcurrencyLimitError("a", 1, 1))).toBe(true);
509
- expect(isFleetManagerError(new FleetManagerShutdownError("test", { timedOut: false }))).toBe(true);
510
- expect(isFleetManagerError(new JobCancelError("test", "unknown"))).toBe(true);
511
- expect(isFleetManagerError(new JobForkError("test", "unknown"))).toBe(true);
512
- });
513
-
514
- it("returns false for regular Error", () => {
515
- expect(isFleetManagerError(new Error("test"))).toBe(false);
516
- });
517
-
518
- it("returns false for non-error values", () => {
519
- expect(isFleetManagerError(null)).toBe(false);
520
- expect(isFleetManagerError(undefined)).toBe(false);
521
- expect(isFleetManagerError("error")).toBe(false);
522
- expect(isFleetManagerError({ message: "error" })).toBe(false);
523
- });
524
- });
525
-
526
- describe("isConfigurationError", () => {
527
- it("returns true for ConfigurationError", () => {
528
- const error = new ConfigurationError("test");
529
- expect(isConfigurationError(error)).toBe(true);
530
- });
531
-
532
- it("returns false for other FleetManagerError types", () => {
533
- expect(isConfigurationError(new FleetManagerError("test"))).toBe(false);
534
- expect(isConfigurationError(new AgentNotFoundError("test"))).toBe(false);
535
- });
536
-
537
- it("returns false for non-error values", () => {
538
- expect(isConfigurationError(null)).toBe(false);
539
- expect(isConfigurationError(new Error("test"))).toBe(false);
540
- });
541
- });
542
-
543
- describe("isAgentNotFoundError", () => {
544
- it("returns true for AgentNotFoundError", () => {
545
- const error = new AgentNotFoundError("test");
546
- expect(isAgentNotFoundError(error)).toBe(true);
547
- });
548
-
549
- it("returns false for other error types", () => {
550
- expect(isAgentNotFoundError(new FleetManagerError("test"))).toBe(false);
551
- expect(isAgentNotFoundError(new JobNotFoundError("test"))).toBe(false);
552
- expect(isAgentNotFoundError(null)).toBe(false);
553
- });
554
- });
555
-
556
- describe("isJobNotFoundError", () => {
557
- it("returns true for JobNotFoundError", () => {
558
- const error = new JobNotFoundError("test");
559
- expect(isJobNotFoundError(error)).toBe(true);
560
- });
561
-
562
- it("returns false for other error types", () => {
563
- expect(isJobNotFoundError(new FleetManagerError("test"))).toBe(false);
564
- expect(isJobNotFoundError(new AgentNotFoundError("test"))).toBe(false);
565
- expect(isJobNotFoundError(null)).toBe(false);
566
- });
567
- });
568
-
569
- describe("isScheduleNotFoundError", () => {
570
- it("returns true for ScheduleNotFoundError", () => {
571
- const error = new ScheduleNotFoundError("agent", "schedule");
572
- expect(isScheduleNotFoundError(error)).toBe(true);
573
- });
574
-
575
- it("returns false for other error types", () => {
576
- expect(isScheduleNotFoundError(new FleetManagerError("test"))).toBe(false);
577
- expect(isScheduleNotFoundError(new AgentNotFoundError("test"))).toBe(false);
578
- expect(isScheduleNotFoundError(null)).toBe(false);
579
- });
580
- });
581
-
582
- describe("isInvalidStateError", () => {
583
- it("returns true for InvalidStateError", () => {
584
- const error = new InvalidStateError("op", "current", "expected");
585
- expect(isInvalidStateError(error)).toBe(true);
586
- });
587
-
588
- it("returns true for FleetManagerStateError (deprecated subclass)", () => {
589
- const error = new FleetManagerStateError("op", "current", "expected");
590
- expect(isInvalidStateError(error)).toBe(true);
591
- });
592
-
593
- it("returns false for other error types", () => {
594
- expect(isInvalidStateError(new FleetManagerError("test"))).toBe(false);
595
- expect(isInvalidStateError(new AgentNotFoundError("test"))).toBe(false);
596
- expect(isInvalidStateError(null)).toBe(false);
597
- });
598
- });
599
-
600
- describe("isConcurrencyLimitError", () => {
601
- it("returns true for ConcurrencyLimitError", () => {
602
- const error = new ConcurrencyLimitError("agent", 3, 3);
603
- expect(isConcurrencyLimitError(error)).toBe(true);
604
- });
605
-
606
- it("returns false for other error types", () => {
607
- expect(isConcurrencyLimitError(new FleetManagerError("test"))).toBe(false);
608
- expect(isConcurrencyLimitError(new AgentNotFoundError("test"))).toBe(false);
609
- expect(isConcurrencyLimitError(null)).toBe(false);
610
- });
611
- });
612
-
613
- describe("isJobCancelError", () => {
614
- it("returns true for JobCancelError", () => {
615
- const error = new JobCancelError("job-123", "not_running");
616
- expect(isJobCancelError(error)).toBe(true);
617
- });
618
-
619
- it("returns false for other error types", () => {
620
- expect(isJobCancelError(new FleetManagerError("test"))).toBe(false);
621
- expect(isJobCancelError(new JobNotFoundError("test"))).toBe(false);
622
- expect(isJobCancelError(null)).toBe(false);
623
- });
624
- });
625
-
626
- describe("isJobForkError", () => {
627
- it("returns true for JobForkError", () => {
628
- const error = new JobForkError("job-123", "no_session");
629
- expect(isJobForkError(error)).toBe(true);
630
- });
631
-
632
- it("returns false for other error types", () => {
633
- expect(isJobForkError(new FleetManagerError("test"))).toBe(false);
634
- expect(isJobForkError(new JobNotFoundError("test"))).toBe(false);
635
- expect(isJobForkError(new JobCancelError("test", "unknown"))).toBe(false);
636
- expect(isJobForkError(null)).toBe(false);
637
- });
638
- });
639
- });
640
-
641
- // ===========================================================================
642
- // Error Codes
643
- // ===========================================================================
644
- describe("FleetManagerErrorCode", () => {
645
- it("contains all expected error codes", () => {
646
- expect(FleetManagerErrorCode.FLEET_MANAGER_ERROR).toBe("FLEET_MANAGER_ERROR");
647
- expect(FleetManagerErrorCode.CONFIGURATION_ERROR).toBe("CONFIGURATION_ERROR");
648
- expect(FleetManagerErrorCode.CONFIG_LOAD_ERROR).toBe("CONFIG_LOAD_ERROR");
649
- expect(FleetManagerErrorCode.AGENT_NOT_FOUND).toBe("AGENT_NOT_FOUND");
650
- expect(FleetManagerErrorCode.JOB_NOT_FOUND).toBe("JOB_NOT_FOUND");
651
- expect(FleetManagerErrorCode.SCHEDULE_NOT_FOUND).toBe("SCHEDULE_NOT_FOUND");
652
- expect(FleetManagerErrorCode.INVALID_STATE).toBe("INVALID_STATE");
653
- expect(FleetManagerErrorCode.STATE_DIR_ERROR).toBe("STATE_DIR_ERROR");
654
- expect(FleetManagerErrorCode.CONCURRENCY_LIMIT).toBe("CONCURRENCY_LIMIT");
655
- expect(FleetManagerErrorCode.SHUTDOWN_ERROR).toBe("SHUTDOWN_ERROR");
656
- expect(FleetManagerErrorCode.JOB_CANCEL_ERROR).toBe("JOB_CANCEL_ERROR");
657
- expect(FleetManagerErrorCode.JOB_FORK_ERROR).toBe("JOB_FORK_ERROR");
658
- });
659
- });
660
- });