@herdctl/core 0.0.1 → 0.0.2

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 (275) hide show
  1. package/dist/config/__tests__/agent.test.js +31 -13
  2. package/dist/config/__tests__/agent.test.js.map +1 -1
  3. package/dist/config/__tests__/merge.test.js +9 -2
  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 +828 -24
  12. package/dist/config/schema.d.ts.map +1 -1
  13. package/dist/config/schema.js +118 -6
  14. package/dist/config/schema.js.map +1 -1
  15. package/dist/fleet-manager/__tests__/coverage.test.js +11 -332
  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 +109 -0
  20. package/dist/fleet-manager/__tests__/integration.test.js.map +1 -1
  21. package/dist/fleet-manager/__tests__/reload.test.js +1 -1
  22. package/dist/fleet-manager/__tests__/reload.test.js.map +1 -1
  23. package/dist/fleet-manager/config-reload.d.ts +164 -0
  24. package/dist/fleet-manager/config-reload.d.ts.map +1 -0
  25. package/dist/fleet-manager/config-reload.js +445 -0
  26. package/dist/fleet-manager/config-reload.js.map +1 -0
  27. package/dist/fleet-manager/context.d.ts +76 -0
  28. package/dist/fleet-manager/context.d.ts.map +1 -0
  29. package/dist/fleet-manager/context.js +11 -0
  30. package/dist/fleet-manager/context.js.map +1 -0
  31. package/dist/fleet-manager/errors.d.ts +0 -25
  32. package/dist/fleet-manager/errors.d.ts.map +1 -1
  33. package/dist/fleet-manager/errors.js +0 -38
  34. package/dist/fleet-manager/errors.js.map +1 -1
  35. package/dist/fleet-manager/event-emitters.d.ts +123 -0
  36. package/dist/fleet-manager/event-emitters.d.ts.map +1 -0
  37. package/dist/fleet-manager/event-emitters.js +136 -0
  38. package/dist/fleet-manager/event-emitters.js.map +1 -0
  39. package/dist/fleet-manager/event-types.d.ts +0 -15
  40. package/dist/fleet-manager/event-types.d.ts.map +1 -1
  41. package/dist/fleet-manager/fleet-manager.d.ts +40 -653
  42. package/dist/fleet-manager/fleet-manager.d.ts.map +1 -1
  43. package/dist/fleet-manager/fleet-manager.js +95 -1720
  44. package/dist/fleet-manager/fleet-manager.js.map +1 -1
  45. package/dist/fleet-manager/index.d.ts +13 -2
  46. package/dist/fleet-manager/index.d.ts.map +1 -1
  47. package/dist/fleet-manager/index.js +19 -6
  48. package/dist/fleet-manager/index.js.map +1 -1
  49. package/dist/fleet-manager/job-control.d.ts +64 -0
  50. package/dist/fleet-manager/job-control.d.ts.map +1 -0
  51. package/dist/fleet-manager/job-control.js +296 -0
  52. package/dist/fleet-manager/job-control.js.map +1 -0
  53. package/dist/fleet-manager/log-streaming.d.ts +171 -0
  54. package/dist/fleet-manager/log-streaming.d.ts.map +1 -0
  55. package/dist/fleet-manager/log-streaming.js +503 -0
  56. package/dist/fleet-manager/log-streaming.js.map +1 -0
  57. package/dist/fleet-manager/schedule-executor.d.ts +63 -0
  58. package/dist/fleet-manager/schedule-executor.d.ts.map +1 -0
  59. package/dist/fleet-manager/schedule-executor.js +209 -0
  60. package/dist/fleet-manager/schedule-executor.js.map +1 -0
  61. package/dist/fleet-manager/schedule-management.d.ts +71 -0
  62. package/dist/fleet-manager/schedule-management.d.ts.map +1 -0
  63. package/dist/fleet-manager/schedule-management.js +171 -0
  64. package/dist/fleet-manager/schedule-management.js.map +1 -0
  65. package/dist/fleet-manager/status-queries.d.ts +105 -0
  66. package/dist/fleet-manager/status-queries.d.ts.map +1 -0
  67. package/dist/fleet-manager/status-queries.js +247 -0
  68. package/dist/fleet-manager/status-queries.js.map +1 -0
  69. package/dist/fleet-manager/types.d.ts +0 -39
  70. package/dist/fleet-manager/types.d.ts.map +1 -1
  71. package/dist/runner/__tests__/job-executor.test.js +206 -1
  72. package/dist/runner/__tests__/job-executor.test.js.map +1 -1
  73. package/dist/runner/job-executor.d.ts +9 -0
  74. package/dist/runner/job-executor.d.ts.map +1 -1
  75. package/dist/runner/job-executor.js +78 -4
  76. package/dist/runner/job-executor.js.map +1 -1
  77. package/dist/runner/types.d.ts +2 -0
  78. package/dist/runner/types.d.ts.map +1 -1
  79. package/dist/scheduler/__tests__/cron.test.d.ts +2 -0
  80. package/dist/scheduler/__tests__/cron.test.d.ts.map +1 -0
  81. package/dist/scheduler/__tests__/cron.test.js +867 -0
  82. package/dist/scheduler/__tests__/cron.test.js.map +1 -0
  83. package/dist/scheduler/__tests__/scheduler.test.js +164 -5
  84. package/dist/scheduler/__tests__/scheduler.test.js.map +1 -1
  85. package/dist/scheduler/cron.d.ts +126 -0
  86. package/dist/scheduler/cron.d.ts.map +1 -0
  87. package/dist/scheduler/cron.js +390 -0
  88. package/dist/scheduler/cron.js.map +1 -0
  89. package/dist/scheduler/errors.d.ts +81 -1
  90. package/dist/scheduler/errors.d.ts.map +1 -1
  91. package/dist/scheduler/errors.js +81 -6
  92. package/dist/scheduler/errors.js.map +1 -1
  93. package/dist/scheduler/index.d.ts +1 -0
  94. package/dist/scheduler/index.d.ts.map +1 -1
  95. package/dist/scheduler/index.js +2 -0
  96. package/dist/scheduler/index.js.map +1 -1
  97. package/dist/scheduler/schedule-runner.d.ts +2 -2
  98. package/dist/scheduler/schedule-runner.d.ts.map +1 -1
  99. package/dist/scheduler/schedule-runner.js +20 -8
  100. package/dist/scheduler/schedule-runner.js.map +1 -1
  101. package/dist/scheduler/scheduler.d.ts +4 -4
  102. package/dist/scheduler/scheduler.d.ts.map +1 -1
  103. package/dist/scheduler/scheduler.js +86 -20
  104. package/dist/scheduler/scheduler.js.map +1 -1
  105. package/dist/scheduler/types.d.ts +1 -1
  106. package/dist/scheduler/types.d.ts.map +1 -1
  107. package/dist/state/schemas/job-metadata.d.ts +2 -2
  108. package/package.json +33 -8
  109. package/.turbo/turbo-build.log +0 -4
  110. package/.turbo/turbo-test.log +0 -219
  111. package/.turbo/turbo-typecheck.log +0 -4
  112. package/coverage/base.css +0 -224
  113. package/coverage/block-navigation.js +0 -87
  114. package/coverage/coverage-final.json +0 -51
  115. package/coverage/favicon.png +0 -0
  116. package/coverage/index.html +0 -251
  117. package/coverage/prettify.css +0 -1
  118. package/coverage/prettify.js +0 -2
  119. package/coverage/sort-arrow-sprite.png +0 -0
  120. package/coverage/sorter.js +0 -210
  121. package/coverage/src/config/index.html +0 -191
  122. package/coverage/src/config/index.ts.html +0 -442
  123. package/coverage/src/config/interpolate.ts.html +0 -652
  124. package/coverage/src/config/loader.ts.html +0 -1501
  125. package/coverage/src/config/merge.ts.html +0 -823
  126. package/coverage/src/config/parser.ts.html +0 -1213
  127. package/coverage/src/config/schema.ts.html +0 -1123
  128. package/coverage/src/fleet-manager/errors.ts.html +0 -2326
  129. package/coverage/src/fleet-manager/event-types.ts.html +0 -1219
  130. package/coverage/src/fleet-manager/fleet-manager.ts.html +0 -7030
  131. package/coverage/src/fleet-manager/index.html +0 -206
  132. package/coverage/src/fleet-manager/index.ts.html +0 -469
  133. package/coverage/src/fleet-manager/job-manager.ts.html +0 -2074
  134. package/coverage/src/fleet-manager/job-queue.ts.html +0 -2479
  135. package/coverage/src/fleet-manager/types.ts.html +0 -2602
  136. package/coverage/src/index.html +0 -116
  137. package/coverage/src/index.ts.html +0 -181
  138. package/coverage/src/runner/errors.ts.html +0 -1006
  139. package/coverage/src/runner/index.html +0 -191
  140. package/coverage/src/runner/index.ts.html +0 -256
  141. package/coverage/src/runner/job-executor.ts.html +0 -1429
  142. package/coverage/src/runner/message-processor.ts.html +0 -1150
  143. package/coverage/src/runner/sdk-adapter.ts.html +0 -658
  144. package/coverage/src/runner/types.ts.html +0 -559
  145. package/coverage/src/scheduler/errors.ts.html +0 -388
  146. package/coverage/src/scheduler/index.html +0 -206
  147. package/coverage/src/scheduler/index.ts.html +0 -244
  148. package/coverage/src/scheduler/interval.ts.html +0 -652
  149. package/coverage/src/scheduler/schedule-runner.ts.html +0 -1411
  150. package/coverage/src/scheduler/schedule-state.ts.html +0 -718
  151. package/coverage/src/scheduler/scheduler.ts.html +0 -1795
  152. package/coverage/src/scheduler/types.ts.html +0 -733
  153. package/coverage/src/state/directory.ts.html +0 -736
  154. package/coverage/src/state/errors.ts.html +0 -376
  155. package/coverage/src/state/fleet-state.ts.html +0 -937
  156. package/coverage/src/state/index.html +0 -221
  157. package/coverage/src/state/index.ts.html +0 -322
  158. package/coverage/src/state/job-metadata.ts.html +0 -1420
  159. package/coverage/src/state/job-output.ts.html +0 -1033
  160. package/coverage/src/state/schemas/fleet-state.ts.html +0 -445
  161. package/coverage/src/state/schemas/index.html +0 -176
  162. package/coverage/src/state/schemas/index.ts.html +0 -286
  163. package/coverage/src/state/schemas/job-metadata.ts.html +0 -628
  164. package/coverage/src/state/schemas/job-output.ts.html +0 -616
  165. package/coverage/src/state/schemas/session-info.ts.html +0 -361
  166. package/coverage/src/state/session.ts.html +0 -844
  167. package/coverage/src/state/types.ts.html +0 -262
  168. package/coverage/src/state/utils/atomic.ts.html +0 -748
  169. package/coverage/src/state/utils/index.html +0 -146
  170. package/coverage/src/state/utils/index.ts.html +0 -103
  171. package/coverage/src/state/utils/reads.ts.html +0 -1621
  172. package/coverage/src/work-sources/adapters/github.ts.html +0 -3583
  173. package/coverage/src/work-sources/adapters/index.html +0 -131
  174. package/coverage/src/work-sources/adapters/index.ts.html +0 -277
  175. package/coverage/src/work-sources/errors.ts.html +0 -298
  176. package/coverage/src/work-sources/index.html +0 -176
  177. package/coverage/src/work-sources/index.ts.html +0 -529
  178. package/coverage/src/work-sources/manager.ts.html +0 -1324
  179. package/coverage/src/work-sources/registry.ts.html +0 -619
  180. package/coverage/src/work-sources/types.ts.html +0 -568
  181. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts +0 -7
  182. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts.map +0 -1
  183. package/dist/fleet-manager/__tests__/event-helpers.test.js +0 -368
  184. package/dist/fleet-manager/__tests__/event-helpers.test.js.map +0 -1
  185. package/src/config/__tests__/agent.test.ts +0 -864
  186. package/src/config/__tests__/interpolate.test.ts +0 -644
  187. package/src/config/__tests__/loader.test.ts +0 -784
  188. package/src/config/__tests__/merge.test.ts +0 -751
  189. package/src/config/__tests__/parser.test.ts +0 -533
  190. package/src/config/__tests__/schema.test.ts +0 -873
  191. package/src/config/index.ts +0 -119
  192. package/src/config/interpolate.ts +0 -189
  193. package/src/config/loader.ts +0 -472
  194. package/src/config/merge.ts +0 -246
  195. package/src/config/parser.ts +0 -376
  196. package/src/config/schema.ts +0 -346
  197. package/src/fleet-manager/__tests__/coverage.test.ts +0 -2869
  198. package/src/fleet-manager/__tests__/errors.test.ts +0 -660
  199. package/src/fleet-manager/__tests__/event-helpers.test.ts +0 -448
  200. package/src/fleet-manager/__tests__/integration.test.ts +0 -1209
  201. package/src/fleet-manager/__tests__/job-control.test.ts +0 -283
  202. package/src/fleet-manager/__tests__/job-manager.test.ts +0 -869
  203. package/src/fleet-manager/__tests__/job-queue.test.ts +0 -401
  204. package/src/fleet-manager/__tests__/reload.test.ts +0 -751
  205. package/src/fleet-manager/__tests__/status-queries.test.ts +0 -595
  206. package/src/fleet-manager/__tests__/trigger.test.ts +0 -601
  207. package/src/fleet-manager/errors.ts +0 -747
  208. package/src/fleet-manager/event-types.ts +0 -378
  209. package/src/fleet-manager/fleet-manager.ts +0 -2315
  210. package/src/fleet-manager/index.ts +0 -128
  211. package/src/fleet-manager/job-manager.ts +0 -663
  212. package/src/fleet-manager/job-queue.ts +0 -798
  213. package/src/fleet-manager/types.ts +0 -839
  214. package/src/index.ts +0 -32
  215. package/src/runner/__tests__/errors.test.ts +0 -382
  216. package/src/runner/__tests__/job-executor.test.ts +0 -1708
  217. package/src/runner/__tests__/message-processor.test.ts +0 -960
  218. package/src/runner/__tests__/sdk-adapter.test.ts +0 -626
  219. package/src/runner/errors.ts +0 -307
  220. package/src/runner/index.ts +0 -57
  221. package/src/runner/job-executor.ts +0 -448
  222. package/src/runner/message-processor.ts +0 -355
  223. package/src/runner/sdk-adapter.ts +0 -191
  224. package/src/runner/types.ts +0 -158
  225. package/src/scheduler/__tests__/errors.test.ts +0 -159
  226. package/src/scheduler/__tests__/interval.test.ts +0 -515
  227. package/src/scheduler/__tests__/schedule-runner.test.ts +0 -798
  228. package/src/scheduler/__tests__/schedule-state.test.ts +0 -671
  229. package/src/scheduler/__tests__/scheduler.test.ts +0 -1280
  230. package/src/scheduler/errors.ts +0 -101
  231. package/src/scheduler/index.ts +0 -53
  232. package/src/scheduler/interval.ts +0 -189
  233. package/src/scheduler/schedule-runner.ts +0 -442
  234. package/src/scheduler/schedule-state.ts +0 -211
  235. package/src/scheduler/scheduler.ts +0 -570
  236. package/src/scheduler/types.ts +0 -216
  237. package/src/state/__tests__/directory.test.ts +0 -595
  238. package/src/state/__tests__/fleet-state.test.ts +0 -868
  239. package/src/state/__tests__/job-metadata-schema.test.ts +0 -414
  240. package/src/state/__tests__/job-metadata.test.ts +0 -831
  241. package/src/state/__tests__/job-output.test.ts +0 -856
  242. package/src/state/__tests__/session-schema.test.ts +0 -378
  243. package/src/state/__tests__/session.test.ts +0 -604
  244. package/src/state/directory.ts +0 -217
  245. package/src/state/errors.ts +0 -97
  246. package/src/state/fleet-state.ts +0 -284
  247. package/src/state/index.ts +0 -79
  248. package/src/state/job-metadata.ts +0 -445
  249. package/src/state/job-output.ts +0 -316
  250. package/src/state/schemas/__tests__/job-output.test.ts +0 -338
  251. package/src/state/schemas/fleet-state.ts +0 -120
  252. package/src/state/schemas/index.ts +0 -67
  253. package/src/state/schemas/job-metadata.ts +0 -181
  254. package/src/state/schemas/job-output.ts +0 -177
  255. package/src/state/schemas/session-info.ts +0 -92
  256. package/src/state/session.ts +0 -253
  257. package/src/state/types.ts +0 -59
  258. package/src/state/utils/__tests__/atomic.test.ts +0 -723
  259. package/src/state/utils/__tests__/reads.test.ts +0 -1071
  260. package/src/state/utils/atomic.ts +0 -221
  261. package/src/state/utils/index.ts +0 -6
  262. package/src/state/utils/reads.ts +0 -512
  263. package/src/work-sources/__tests__/github.test.ts +0 -1800
  264. package/src/work-sources/__tests__/manager.test.ts +0 -529
  265. package/src/work-sources/__tests__/registry.test.ts +0 -477
  266. package/src/work-sources/__tests__/types.test.ts +0 -479
  267. package/src/work-sources/adapters/github.ts +0 -1166
  268. package/src/work-sources/adapters/index.ts +0 -64
  269. package/src/work-sources/errors.ts +0 -71
  270. package/src/work-sources/index.ts +0 -148
  271. package/src/work-sources/manager.ts +0 -413
  272. package/src/work-sources/registry.ts +0 -178
  273. package/src/work-sources/types.ts +0 -161
  274. package/tsconfig.json +0 -9
  275. 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
- });