@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,873 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import {
3
- FleetConfigSchema,
4
- DefaultsSchema,
5
- WorkspaceSchema,
6
- PermissionsSchema,
7
- PermissionModeSchema,
8
- WorkSourceSchema,
9
- GitHubWorkSourceSchema,
10
- GitHubAuthSchema,
11
- BaseWorkSourceSchema,
12
- DockerSchema,
13
- ChatSchema,
14
- WebhooksSchema,
15
- InstancesSchema,
16
- AgentReferenceSchema,
17
- } from "../schema.js";
18
-
19
- describe("FleetConfigSchema", () => {
20
- it("parses minimal config", () => {
21
- const result = FleetConfigSchema.safeParse({});
22
- expect(result.success).toBe(true);
23
- if (result.success) {
24
- expect(result.data.version).toBe(1);
25
- expect(result.data.agents).toEqual([]);
26
- }
27
- });
28
-
29
- it("parses complete config", () => {
30
- const config = {
31
- version: 1,
32
- fleet: { name: "test", description: "test fleet" },
33
- defaults: {},
34
- workspace: { root: "/tmp" },
35
- agents: [{ path: "./test.yaml" }],
36
- chat: {},
37
- webhooks: {},
38
- docker: {},
39
- };
40
- const result = FleetConfigSchema.safeParse(config);
41
- expect(result.success).toBe(true);
42
- });
43
-
44
- it("rejects invalid version", () => {
45
- const result = FleetConfigSchema.safeParse({ version: "1" });
46
- expect(result.success).toBe(false);
47
- });
48
-
49
- it("rejects negative version", () => {
50
- const result = FleetConfigSchema.safeParse({ version: -1 });
51
- expect(result.success).toBe(false);
52
- });
53
-
54
- it("rejects zero version", () => {
55
- const result = FleetConfigSchema.safeParse({ version: 0 });
56
- expect(result.success).toBe(false);
57
- });
58
- });
59
-
60
- describe("DefaultsSchema", () => {
61
- it("parses empty defaults", () => {
62
- const result = DefaultsSchema.safeParse({});
63
- expect(result.success).toBe(true);
64
- });
65
-
66
- it("parses complete defaults", () => {
67
- const defaults = {
68
- docker: { enabled: true },
69
- permissions: { mode: "acceptEdits" },
70
- work_source: { type: "github" },
71
- instances: { max_concurrent: 2 },
72
- };
73
- const result = DefaultsSchema.safeParse(defaults);
74
- expect(result.success).toBe(true);
75
- if (result.success) {
76
- expect(result.data.docker?.enabled).toBe(true);
77
- expect(result.data.permissions?.mode).toBe("acceptEdits");
78
- expect(result.data.work_source?.type).toBe("github");
79
- expect(result.data.instances?.max_concurrent).toBe(2);
80
- }
81
- });
82
-
83
- it("parses extended defaults with session", () => {
84
- const defaults = {
85
- session: {
86
- max_turns: 50,
87
- timeout: "30m",
88
- model: "claude-sonnet-4-20250514",
89
- },
90
- };
91
- const result = DefaultsSchema.safeParse(defaults);
92
- expect(result.success).toBe(true);
93
- if (result.success) {
94
- expect(result.data.session?.max_turns).toBe(50);
95
- expect(result.data.session?.timeout).toBe("30m");
96
- expect(result.data.session?.model).toBe("claude-sonnet-4-20250514");
97
- }
98
- });
99
-
100
- it("parses extended defaults with model", () => {
101
- const defaults = {
102
- model: "claude-opus-4-20250514",
103
- };
104
- const result = DefaultsSchema.safeParse(defaults);
105
- expect(result.success).toBe(true);
106
- if (result.success) {
107
- expect(result.data.model).toBe("claude-opus-4-20250514");
108
- }
109
- });
110
-
111
- it("parses extended defaults with max_turns", () => {
112
- const defaults = {
113
- max_turns: 100,
114
- };
115
- const result = DefaultsSchema.safeParse(defaults);
116
- expect(result.success).toBe(true);
117
- if (result.success) {
118
- expect(result.data.max_turns).toBe(100);
119
- }
120
- });
121
-
122
- it("parses extended defaults with permission_mode", () => {
123
- const defaults = {
124
- permission_mode: "bypassPermissions",
125
- };
126
- const result = DefaultsSchema.safeParse(defaults);
127
- expect(result.success).toBe(true);
128
- if (result.success) {
129
- expect(result.data.permission_mode).toBe("bypassPermissions");
130
- }
131
- });
132
-
133
- it("parses complete extended defaults", () => {
134
- const defaults = {
135
- docker: { enabled: false },
136
- permissions: {
137
- mode: "acceptEdits",
138
- allowed_tools: ["Read", "Write"],
139
- },
140
- work_source: {
141
- type: "github",
142
- labels: { ready: "ready" },
143
- },
144
- instances: { max_concurrent: 3 },
145
- session: {
146
- max_turns: 50,
147
- timeout: "1h",
148
- },
149
- model: "claude-sonnet-4-20250514",
150
- max_turns: 100,
151
- permission_mode: "acceptEdits",
152
- };
153
- const result = DefaultsSchema.safeParse(defaults);
154
- expect(result.success).toBe(true);
155
- if (result.success) {
156
- expect(result.data.session?.max_turns).toBe(50);
157
- expect(result.data.model).toBe("claude-sonnet-4-20250514");
158
- expect(result.data.max_turns).toBe(100);
159
- expect(result.data.permission_mode).toBe("acceptEdits");
160
- }
161
- });
162
-
163
- it("rejects invalid permission_mode", () => {
164
- const defaults = {
165
- permission_mode: "invalid",
166
- };
167
- const result = DefaultsSchema.safeParse(defaults);
168
- expect(result.success).toBe(false);
169
- });
170
-
171
- it("rejects negative max_turns", () => {
172
- const defaults = {
173
- max_turns: -1,
174
- };
175
- const result = DefaultsSchema.safeParse(defaults);
176
- expect(result.success).toBe(false);
177
- });
178
-
179
- it("rejects zero max_turns", () => {
180
- const defaults = {
181
- max_turns: 0,
182
- };
183
- const result = DefaultsSchema.safeParse(defaults);
184
- expect(result.success).toBe(false);
185
- });
186
-
187
- it("rejects non-integer max_turns", () => {
188
- const defaults = {
189
- max_turns: 1.5,
190
- };
191
- const result = DefaultsSchema.safeParse(defaults);
192
- expect(result.success).toBe(false);
193
- });
194
- });
195
-
196
- describe("WorkspaceSchema", () => {
197
- it("requires root", () => {
198
- const result = WorkspaceSchema.safeParse({});
199
- expect(result.success).toBe(false);
200
- });
201
-
202
- it("parses with root only", () => {
203
- const result = WorkspaceSchema.safeParse({ root: "/tmp/workspace" });
204
- expect(result.success).toBe(true);
205
- if (result.success) {
206
- expect(result.data.root).toBe("/tmp/workspace");
207
- expect(result.data.auto_clone).toBe(true);
208
- expect(result.data.clone_depth).toBe(1);
209
- expect(result.data.default_branch).toBe("main");
210
- }
211
- });
212
-
213
- it("parses complete workspace config", () => {
214
- const workspace = {
215
- root: "~/herdctl-workspace",
216
- auto_clone: false,
217
- clone_depth: 5,
218
- default_branch: "develop",
219
- };
220
- const result = WorkspaceSchema.safeParse(workspace);
221
- expect(result.success).toBe(true);
222
- if (result.success) {
223
- expect(result.data.auto_clone).toBe(false);
224
- expect(result.data.clone_depth).toBe(5);
225
- expect(result.data.default_branch).toBe("develop");
226
- }
227
- });
228
-
229
- it("rejects non-integer clone_depth", () => {
230
- const result = WorkspaceSchema.safeParse({
231
- root: "/tmp",
232
- clone_depth: 1.5,
233
- });
234
- expect(result.success).toBe(false);
235
- });
236
-
237
- it("rejects zero clone_depth", () => {
238
- const result = WorkspaceSchema.safeParse({ root: "/tmp", clone_depth: 0 });
239
- expect(result.success).toBe(false);
240
- });
241
- });
242
-
243
- describe("PermissionsSchema", () => {
244
- it("applies default mode", () => {
245
- const result = PermissionsSchema.safeParse({});
246
- expect(result.success).toBe(true);
247
- if (result.success) {
248
- expect(result.data.mode).toBe("acceptEdits");
249
- }
250
- });
251
-
252
- it("parses all fields", () => {
253
- const permissions = {
254
- mode: "bypassPermissions",
255
- allowed_tools: ["Read", "Edit"],
256
- denied_tools: ["WebSearch"],
257
- bash: {
258
- allowed_commands: ["git", "npm"],
259
- denied_patterns: ["rm -rf /"],
260
- },
261
- };
262
- const result = PermissionsSchema.safeParse(permissions);
263
- expect(result.success).toBe(true);
264
- if (result.success) {
265
- expect(result.data.mode).toBe("bypassPermissions");
266
- expect(result.data.allowed_tools).toEqual(["Read", "Edit"]);
267
- expect(result.data.denied_tools).toEqual(["WebSearch"]);
268
- expect(result.data.bash?.allowed_commands).toEqual(["git", "npm"]);
269
- }
270
- });
271
- });
272
-
273
- describe("PermissionModeSchema", () => {
274
- it("accepts valid modes", () => {
275
- const validModes = ["default", "acceptEdits", "bypassPermissions", "plan"];
276
- for (const mode of validModes) {
277
- const result = PermissionModeSchema.safeParse(mode);
278
- expect(result.success).toBe(true);
279
- }
280
- });
281
-
282
- it("rejects invalid modes", () => {
283
- const result = PermissionModeSchema.safeParse("invalid");
284
- expect(result.success).toBe(false);
285
- });
286
- });
287
-
288
- describe("WorkSourceSchema", () => {
289
- it("requires type", () => {
290
- const result = WorkSourceSchema.safeParse({});
291
- expect(result.success).toBe(false);
292
- });
293
-
294
- it("parses minimal github type (base schema)", () => {
295
- const result = WorkSourceSchema.safeParse({ type: "github" });
296
- expect(result.success).toBe(true);
297
- if (result.success) {
298
- expect(result.data.type).toBe("github");
299
- }
300
- });
301
-
302
- it("parses with labels (base schema)", () => {
303
- const workSource = {
304
- type: "github",
305
- labels: {
306
- ready: "ready",
307
- in_progress: "in-progress",
308
- },
309
- cleanup_in_progress: true,
310
- };
311
- const result = WorkSourceSchema.safeParse(workSource);
312
- expect(result.success).toBe(true);
313
- if (result.success) {
314
- expect(result.data.labels?.ready).toBe("ready");
315
- expect(result.data.cleanup_in_progress).toBe(true);
316
- }
317
- });
318
-
319
- it("rejects invalid type", () => {
320
- const result = WorkSourceSchema.safeParse({ type: "jira" });
321
- expect(result.success).toBe(false);
322
- });
323
-
324
- it("parses full GitHub work source configuration", () => {
325
- const workSource = {
326
- type: "github",
327
- repo: "owner/repo-name",
328
- labels: {
329
- ready: "ready-for-agent",
330
- in_progress: "agent-working",
331
- },
332
- exclude_labels: ["blocked", "wip"],
333
- cleanup_on_failure: true,
334
- auth: {
335
- token_env: "MY_GITHUB_TOKEN",
336
- },
337
- };
338
- const result = WorkSourceSchema.safeParse(workSource);
339
- expect(result.success).toBe(true);
340
- if (result.success) {
341
- expect(result.data.type).toBe("github");
342
- expect(result.data).toHaveProperty("repo", "owner/repo-name");
343
- }
344
- });
345
- });
346
-
347
- describe("GitHubWorkSourceSchema", () => {
348
- describe("repo field validation", () => {
349
- it("requires repo field", () => {
350
- const result = GitHubWorkSourceSchema.safeParse({ type: "github" });
351
- expect(result.success).toBe(false);
352
- if (!result.success) {
353
- expect(result.error.issues.some((i) => i.path.includes("repo"))).toBe(
354
- true
355
- );
356
- }
357
- });
358
-
359
- it("accepts valid owner/repo format", () => {
360
- const result = GitHubWorkSourceSchema.safeParse({
361
- type: "github",
362
- repo: "octocat/hello-world",
363
- });
364
- expect(result.success).toBe(true);
365
- if (result.success) {
366
- expect(result.data.repo).toBe("octocat/hello-world");
367
- }
368
- });
369
-
370
- it("accepts repo with hyphens and underscores", () => {
371
- const result = GitHubWorkSourceSchema.safeParse({
372
- type: "github",
373
- repo: "my-org/my_repo-name",
374
- });
375
- expect(result.success).toBe(true);
376
- });
377
-
378
- it("accepts repo with dots", () => {
379
- const result = GitHubWorkSourceSchema.safeParse({
380
- type: "github",
381
- repo: "org.name/repo.name",
382
- });
383
- expect(result.success).toBe(true);
384
- });
385
-
386
- it("accepts repo with numbers", () => {
387
- const result = GitHubWorkSourceSchema.safeParse({
388
- type: "github",
389
- repo: "org123/repo456",
390
- });
391
- expect(result.success).toBe(true);
392
- });
393
-
394
- it("rejects repo without slash", () => {
395
- const result = GitHubWorkSourceSchema.safeParse({
396
- type: "github",
397
- repo: "just-repo-name",
398
- });
399
- expect(result.success).toBe(false);
400
- if (!result.success) {
401
- expect(result.error.issues[0].message).toContain("owner/repo");
402
- }
403
- });
404
-
405
- it("rejects repo with multiple slashes", () => {
406
- const result = GitHubWorkSourceSchema.safeParse({
407
- type: "github",
408
- repo: "owner/repo/extra",
409
- });
410
- expect(result.success).toBe(false);
411
- });
412
-
413
- it("rejects empty repo", () => {
414
- const result = GitHubWorkSourceSchema.safeParse({
415
- type: "github",
416
- repo: "",
417
- });
418
- expect(result.success).toBe(false);
419
- });
420
-
421
- it("rejects repo with spaces", () => {
422
- const result = GitHubWorkSourceSchema.safeParse({
423
- type: "github",
424
- repo: "owner name/repo name",
425
- });
426
- expect(result.success).toBe(false);
427
- });
428
-
429
- it("provides clear error message for invalid repo format", () => {
430
- const result = GitHubWorkSourceSchema.safeParse({
431
- type: "github",
432
- repo: "invalid",
433
- });
434
- expect(result.success).toBe(false);
435
- if (!result.success) {
436
- const repoError = result.error.issues.find((i) =>
437
- i.path.includes("repo")
438
- );
439
- expect(repoError?.message).toContain("owner/repo");
440
- expect(repoError?.message).toContain("octocat/hello-world");
441
- }
442
- });
443
- });
444
-
445
- describe("labels field", () => {
446
- it("applies default labels when not specified", () => {
447
- const result = GitHubWorkSourceSchema.safeParse({
448
- type: "github",
449
- repo: "owner/repo",
450
- });
451
- expect(result.success).toBe(true);
452
- if (result.success) {
453
- expect(result.data.labels.ready).toBe("ready");
454
- expect(result.data.labels.in_progress).toBe("agent-working");
455
- }
456
- });
457
-
458
- it("allows custom ready label", () => {
459
- const result = GitHubWorkSourceSchema.safeParse({
460
- type: "github",
461
- repo: "owner/repo",
462
- labels: { ready: "custom-ready" },
463
- });
464
- expect(result.success).toBe(true);
465
- if (result.success) {
466
- expect(result.data.labels.ready).toBe("custom-ready");
467
- expect(result.data.labels.in_progress).toBe("agent-working");
468
- }
469
- });
470
-
471
- it("allows custom in_progress label", () => {
472
- const result = GitHubWorkSourceSchema.safeParse({
473
- type: "github",
474
- repo: "owner/repo",
475
- labels: { in_progress: "working-on-it" },
476
- });
477
- expect(result.success).toBe(true);
478
- if (result.success) {
479
- expect(result.data.labels.ready).toBe("ready");
480
- expect(result.data.labels.in_progress).toBe("working-on-it");
481
- }
482
- });
483
-
484
- it("allows both custom labels", () => {
485
- const result = GitHubWorkSourceSchema.safeParse({
486
- type: "github",
487
- repo: "owner/repo",
488
- labels: {
489
- ready: "todo",
490
- in_progress: "doing",
491
- },
492
- });
493
- expect(result.success).toBe(true);
494
- if (result.success) {
495
- expect(result.data.labels.ready).toBe("todo");
496
- expect(result.data.labels.in_progress).toBe("doing");
497
- }
498
- });
499
- });
500
-
501
- describe("exclude_labels field", () => {
502
- it("defaults to empty array", () => {
503
- const result = GitHubWorkSourceSchema.safeParse({
504
- type: "github",
505
- repo: "owner/repo",
506
- });
507
- expect(result.success).toBe(true);
508
- if (result.success) {
509
- expect(result.data.exclude_labels).toEqual([]);
510
- }
511
- });
512
-
513
- it("accepts array of strings", () => {
514
- const result = GitHubWorkSourceSchema.safeParse({
515
- type: "github",
516
- repo: "owner/repo",
517
- exclude_labels: ["blocked", "wip", "on-hold"],
518
- });
519
- expect(result.success).toBe(true);
520
- if (result.success) {
521
- expect(result.data.exclude_labels).toEqual([
522
- "blocked",
523
- "wip",
524
- "on-hold",
525
- ]);
526
- }
527
- });
528
-
529
- it("accepts empty array", () => {
530
- const result = GitHubWorkSourceSchema.safeParse({
531
- type: "github",
532
- repo: "owner/repo",
533
- exclude_labels: [],
534
- });
535
- expect(result.success).toBe(true);
536
- if (result.success) {
537
- expect(result.data.exclude_labels).toEqual([]);
538
- }
539
- });
540
-
541
- it("rejects non-string array items", () => {
542
- const result = GitHubWorkSourceSchema.safeParse({
543
- type: "github",
544
- repo: "owner/repo",
545
- exclude_labels: ["valid", 123],
546
- });
547
- expect(result.success).toBe(false);
548
- });
549
- });
550
-
551
- describe("cleanup_on_failure field", () => {
552
- it("defaults to true", () => {
553
- const result = GitHubWorkSourceSchema.safeParse({
554
- type: "github",
555
- repo: "owner/repo",
556
- });
557
- expect(result.success).toBe(true);
558
- if (result.success) {
559
- expect(result.data.cleanup_on_failure).toBe(true);
560
- }
561
- });
562
-
563
- it("accepts explicit true", () => {
564
- const result = GitHubWorkSourceSchema.safeParse({
565
- type: "github",
566
- repo: "owner/repo",
567
- cleanup_on_failure: true,
568
- });
569
- expect(result.success).toBe(true);
570
- if (result.success) {
571
- expect(result.data.cleanup_on_failure).toBe(true);
572
- }
573
- });
574
-
575
- it("accepts false", () => {
576
- const result = GitHubWorkSourceSchema.safeParse({
577
- type: "github",
578
- repo: "owner/repo",
579
- cleanup_on_failure: false,
580
- });
581
- expect(result.success).toBe(true);
582
- if (result.success) {
583
- expect(result.data.cleanup_on_failure).toBe(false);
584
- }
585
- });
586
-
587
- it("rejects non-boolean values", () => {
588
- const result = GitHubWorkSourceSchema.safeParse({
589
- type: "github",
590
- repo: "owner/repo",
591
- cleanup_on_failure: "yes",
592
- });
593
- expect(result.success).toBe(false);
594
- });
595
- });
596
-
597
- describe("auth field", () => {
598
- it("defaults auth.token_env to GITHUB_TOKEN", () => {
599
- const result = GitHubWorkSourceSchema.safeParse({
600
- type: "github",
601
- repo: "owner/repo",
602
- });
603
- expect(result.success).toBe(true);
604
- if (result.success) {
605
- expect(result.data.auth.token_env).toBe("GITHUB_TOKEN");
606
- }
607
- });
608
-
609
- it("accepts custom token_env", () => {
610
- const result = GitHubWorkSourceSchema.safeParse({
611
- type: "github",
612
- repo: "owner/repo",
613
- auth: { token_env: "MY_GITHUB_PAT" },
614
- });
615
- expect(result.success).toBe(true);
616
- if (result.success) {
617
- expect(result.data.auth.token_env).toBe("MY_GITHUB_PAT");
618
- }
619
- });
620
-
621
- it("accepts empty auth object (uses defaults)", () => {
622
- const result = GitHubWorkSourceSchema.safeParse({
623
- type: "github",
624
- repo: "owner/repo",
625
- auth: {},
626
- });
627
- expect(result.success).toBe(true);
628
- if (result.success) {
629
- expect(result.data.auth.token_env).toBe("GITHUB_TOKEN");
630
- }
631
- });
632
- });
633
-
634
- describe("complete configuration", () => {
635
- it("parses complete GitHub work source config", () => {
636
- const config = {
637
- type: "github",
638
- repo: "my-org/my-repo",
639
- labels: {
640
- ready: "ready-for-work",
641
- in_progress: "in-progress",
642
- },
643
- exclude_labels: ["blocked", "wip", "needs-review"],
644
- cleanup_on_failure: false,
645
- auth: {
646
- token_env: "GH_ENTERPRISE_TOKEN",
647
- },
648
- };
649
- const result = GitHubWorkSourceSchema.safeParse(config);
650
- expect(result.success).toBe(true);
651
- if (result.success) {
652
- expect(result.data).toEqual({
653
- type: "github",
654
- repo: "my-org/my-repo",
655
- labels: {
656
- ready: "ready-for-work",
657
- in_progress: "in-progress",
658
- },
659
- exclude_labels: ["blocked", "wip", "needs-review"],
660
- cleanup_on_failure: false,
661
- auth: {
662
- token_env: "GH_ENTERPRISE_TOKEN",
663
- },
664
- });
665
- }
666
- });
667
-
668
- it("applies all defaults for minimal config", () => {
669
- const result = GitHubWorkSourceSchema.safeParse({
670
- type: "github",
671
- repo: "owner/repo",
672
- });
673
- expect(result.success).toBe(true);
674
- if (result.success) {
675
- expect(result.data.type).toBe("github");
676
- expect(result.data.repo).toBe("owner/repo");
677
- expect(result.data.labels.ready).toBe("ready");
678
- expect(result.data.labels.in_progress).toBe("agent-working");
679
- expect(result.data.exclude_labels).toEqual([]);
680
- expect(result.data.cleanup_on_failure).toBe(true);
681
- expect(result.data.auth.token_env).toBe("GITHUB_TOKEN");
682
- }
683
- });
684
- });
685
- });
686
-
687
- describe("GitHubAuthSchema", () => {
688
- it("applies default token_env", () => {
689
- const result = GitHubAuthSchema.safeParse({});
690
- expect(result.success).toBe(true);
691
- if (result.success) {
692
- expect(result.data.token_env).toBe("GITHUB_TOKEN");
693
- }
694
- });
695
-
696
- it("accepts custom token_env", () => {
697
- const result = GitHubAuthSchema.safeParse({ token_env: "CUSTOM_TOKEN" });
698
- expect(result.success).toBe(true);
699
- if (result.success) {
700
- expect(result.data.token_env).toBe("CUSTOM_TOKEN");
701
- }
702
- });
703
- });
704
-
705
- describe("BaseWorkSourceSchema", () => {
706
- it("parses minimal config", () => {
707
- const result = BaseWorkSourceSchema.safeParse({ type: "github" });
708
- expect(result.success).toBe(true);
709
- });
710
-
711
- it("parses with optional fields", () => {
712
- const result = BaseWorkSourceSchema.safeParse({
713
- type: "github",
714
- labels: { ready: "todo" },
715
- cleanup_in_progress: true,
716
- });
717
- expect(result.success).toBe(true);
718
- });
719
- });
720
-
721
- describe("DockerSchema", () => {
722
- it("applies default enabled", () => {
723
- const result = DockerSchema.safeParse({});
724
- expect(result.success).toBe(true);
725
- if (result.success) {
726
- expect(result.data.enabled).toBe(false);
727
- }
728
- });
729
-
730
- it("parses complete docker config", () => {
731
- const docker = {
732
- enabled: true,
733
- base_image: "herdctl-base:latest",
734
- };
735
- const result = DockerSchema.safeParse(docker);
736
- expect(result.success).toBe(true);
737
- if (result.success) {
738
- expect(result.data.enabled).toBe(true);
739
- expect(result.data.base_image).toBe("herdctl-base:latest");
740
- }
741
- });
742
- });
743
-
744
- describe("ChatSchema", () => {
745
- it("parses empty chat", () => {
746
- const result = ChatSchema.safeParse({});
747
- expect(result.success).toBe(true);
748
- });
749
-
750
- it("parses discord config", () => {
751
- const chat = {
752
- discord: {
753
- enabled: true,
754
- token_env: "DISCORD_TOKEN",
755
- },
756
- };
757
- const result = ChatSchema.safeParse(chat);
758
- expect(result.success).toBe(true);
759
- if (result.success) {
760
- expect(result.data.discord?.enabled).toBe(true);
761
- expect(result.data.discord?.token_env).toBe("DISCORD_TOKEN");
762
- }
763
- });
764
-
765
- it("applies default discord enabled", () => {
766
- const result = ChatSchema.safeParse({ discord: {} });
767
- expect(result.success).toBe(true);
768
- if (result.success) {
769
- expect(result.data.discord?.enabled).toBe(false);
770
- }
771
- });
772
- });
773
-
774
- describe("WebhooksSchema", () => {
775
- it("applies defaults", () => {
776
- const result = WebhooksSchema.safeParse({});
777
- expect(result.success).toBe(true);
778
- if (result.success) {
779
- expect(result.data.enabled).toBe(false);
780
- expect(result.data.port).toBe(8081);
781
- }
782
- });
783
-
784
- it("parses complete webhooks config", () => {
785
- const webhooks = {
786
- enabled: true,
787
- port: 9000,
788
- secret_env: "WEBHOOK_SECRET",
789
- };
790
- const result = WebhooksSchema.safeParse(webhooks);
791
- expect(result.success).toBe(true);
792
- if (result.success) {
793
- expect(result.data.enabled).toBe(true);
794
- expect(result.data.port).toBe(9000);
795
- expect(result.data.secret_env).toBe("WEBHOOK_SECRET");
796
- }
797
- });
798
-
799
- it("rejects negative port", () => {
800
- const result = WebhooksSchema.safeParse({ port: -1 });
801
- expect(result.success).toBe(false);
802
- });
803
-
804
- it("rejects zero port", () => {
805
- const result = WebhooksSchema.safeParse({ port: 0 });
806
- expect(result.success).toBe(false);
807
- });
808
-
809
- it("rejects non-integer port", () => {
810
- const result = WebhooksSchema.safeParse({ port: 80.5 });
811
- expect(result.success).toBe(false);
812
- });
813
- });
814
-
815
- describe("InstancesSchema", () => {
816
- it("applies default max_concurrent", () => {
817
- const result = InstancesSchema.safeParse({});
818
- expect(result.success).toBe(true);
819
- if (result.success) {
820
- expect(result.data.max_concurrent).toBe(1);
821
- }
822
- });
823
-
824
- it("parses custom max_concurrent", () => {
825
- const result = InstancesSchema.safeParse({ max_concurrent: 5 });
826
- expect(result.success).toBe(true);
827
- if (result.success) {
828
- expect(result.data.max_concurrent).toBe(5);
829
- }
830
- });
831
-
832
- it("rejects negative max_concurrent", () => {
833
- const result = InstancesSchema.safeParse({ max_concurrent: -1 });
834
- expect(result.success).toBe(false);
835
- });
836
-
837
- it("rejects zero max_concurrent", () => {
838
- const result = InstancesSchema.safeParse({ max_concurrent: 0 });
839
- expect(result.success).toBe(false);
840
- });
841
-
842
- it("rejects non-integer max_concurrent", () => {
843
- const result = InstancesSchema.safeParse({ max_concurrent: 1.5 });
844
- expect(result.success).toBe(false);
845
- });
846
- });
847
-
848
- describe("AgentReferenceSchema", () => {
849
- it("requires path", () => {
850
- const result = AgentReferenceSchema.safeParse({});
851
- expect(result.success).toBe(false);
852
- });
853
-
854
- it("parses valid path", () => {
855
- const result = AgentReferenceSchema.safeParse({
856
- path: "./agents/test.yaml",
857
- });
858
- expect(result.success).toBe(true);
859
- if (result.success) {
860
- expect(result.data.path).toBe("./agents/test.yaml");
861
- }
862
- });
863
-
864
- it("parses absolute path", () => {
865
- const result = AgentReferenceSchema.safeParse({
866
- path: "/etc/herdctl/agent.yaml",
867
- });
868
- expect(result.success).toBe(true);
869
- if (result.success) {
870
- expect(result.data.path).toBe("/etc/herdctl/agent.yaml");
871
- }
872
- });
873
- });