@deepintel-ltd/farmpro-contracts 1.34.2 → 1.35.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.
@@ -0,0 +1,651 @@
1
+ import { z } from 'zod';
2
+ export declare const nutrientPlanRouter: {
3
+ forField: {
4
+ pathParams: z.ZodObject<{
5
+ farmId: z.ZodString;
6
+ fieldId: z.ZodString;
7
+ }, "strip", z.ZodTypeAny, {
8
+ farmId: string;
9
+ fieldId: string;
10
+ }, {
11
+ farmId: string;
12
+ fieldId: string;
13
+ }>;
14
+ query: z.ZodObject<{
15
+ /** Target kg of fresh fruit per plant; clamped to the crop sheet's range. */
16
+ yieldTarget: z.ZodOptional<z.ZodNumber>;
17
+ /** One of the fertilizer sets, e.g. kno3-agrovert, agrovert-range, standard-soluble. */
18
+ fertilizerSet: z.ZodOptional<z.ZodString>;
19
+ /** True when the beds are under plastic mulch. */
20
+ mulched: z.ZodOptional<z.ZodEffects<z.ZodEnum<["true", "false"]>, boolean, "true" | "false">>;
21
+ /** Client calendar date (YYYY-MM-DD), so the stage matches the farmer's day. */
22
+ today: z.ZodOptional<z.ZodString>;
23
+ }, "strip", z.ZodTypeAny, {
24
+ today?: string | undefined;
25
+ fertilizerSet?: string | undefined;
26
+ yieldTarget?: number | undefined;
27
+ mulched?: boolean | undefined;
28
+ }, {
29
+ today?: string | undefined;
30
+ fertilizerSet?: string | undefined;
31
+ yieldTarget?: number | undefined;
32
+ mulched?: "true" | "false" | undefined;
33
+ }>;
34
+ summary: "Per-plant fertigation plan for a field at its current growth stage";
35
+ method: "GET";
36
+ path: "/farms/:farmId/fields/:fieldId/nutrient-plan";
37
+ responses: {
38
+ 200: z.ZodObject<{
39
+ fieldId: z.ZodString;
40
+ crop: z.ZodNullable<z.ZodString>;
41
+ status: z.ZodEnum<["ok", "unsupported-crop", "not-transplanted"]>;
42
+ message: z.ZodNullable<z.ZodString>;
43
+ plan: z.ZodNullable<z.ZodObject<{
44
+ sheet: z.ZodObject<{
45
+ id: z.ZodString;
46
+ version: z.ZodNumber;
47
+ label: z.ZodString;
48
+ evidenceLevel: z.ZodEnum<["A", "B", "C"]>;
49
+ approvedBy: z.ZodString;
50
+ approvedAt: z.ZodString;
51
+ summary: z.ZodString;
52
+ yieldBasis: z.ZodString;
53
+ }, "strip", z.ZodTypeAny, {
54
+ id: string;
55
+ summary: string;
56
+ label: string;
57
+ version: number;
58
+ evidenceLevel: "A" | "B" | "C";
59
+ approvedBy: string;
60
+ approvedAt: string;
61
+ yieldBasis: string;
62
+ }, {
63
+ id: string;
64
+ summary: string;
65
+ label: string;
66
+ version: number;
67
+ evidenceLevel: "A" | "B" | "C";
68
+ approvedBy: string;
69
+ approvedAt: string;
70
+ yieldBasis: string;
71
+ }>;
72
+ stage: z.ZodObject<{
73
+ id: z.ZodString;
74
+ label: z.ZodString;
75
+ railLabel: z.ZodString;
76
+ dayStart: z.ZodNumber;
77
+ dayEnd: z.ZodNumber;
78
+ }, "strip", z.ZodTypeAny, {
79
+ id: string;
80
+ label: string;
81
+ railLabel: string;
82
+ dayStart: number;
83
+ dayEnd: number;
84
+ }, {
85
+ id: string;
86
+ label: string;
87
+ railLabel: string;
88
+ dayStart: number;
89
+ dayEnd: number;
90
+ }>;
91
+ fieldDay: z.ZodNumber;
92
+ yieldTargetKgPerPlant: z.ZodNumber;
93
+ feedIntensity: z.ZodNumber;
94
+ plantCount: z.ZodNullable<z.ZodNumber>;
95
+ weeklyPerPlantG: z.ZodObject<{
96
+ N: z.ZodNumber;
97
+ P2O5: z.ZodNumber;
98
+ K2O: z.ZodNumber;
99
+ CaO: z.ZodNumber;
100
+ MgO: z.ZodNumber;
101
+ }, "strip", z.ZodTypeAny, {
102
+ N: number;
103
+ P2O5: number;
104
+ K2O: number;
105
+ CaO: number;
106
+ MgO: number;
107
+ }, {
108
+ N: number;
109
+ P2O5: number;
110
+ K2O: number;
111
+ CaO: number;
112
+ MgO: number;
113
+ }>;
114
+ weeklyFieldKg: z.ZodNullable<z.ZodObject<{
115
+ N: z.ZodNumber;
116
+ P2O5: z.ZodNumber;
117
+ K2O: z.ZodNumber;
118
+ CaO: z.ZodNumber;
119
+ MgO: z.ZodNumber;
120
+ }, "strip", z.ZodTypeAny, {
121
+ N: number;
122
+ P2O5: number;
123
+ K2O: number;
124
+ CaO: number;
125
+ MgO: number;
126
+ }, {
127
+ N: number;
128
+ P2O5: number;
129
+ K2O: number;
130
+ CaO: number;
131
+ MgO: number;
132
+ }>>;
133
+ deliveredPerPlantG: z.ZodObject<{
134
+ N: z.ZodNumber;
135
+ P2O5: z.ZodNumber;
136
+ K2O: z.ZodNumber;
137
+ CaO: z.ZodNumber;
138
+ MgO: z.ZodNumber;
139
+ }, "strip", z.ZodTypeAny, {
140
+ N: number;
141
+ P2O5: number;
142
+ K2O: number;
143
+ CaO: number;
144
+ MgO: number;
145
+ }, {
146
+ N: number;
147
+ P2O5: number;
148
+ K2O: number;
149
+ CaO: number;
150
+ MgO: number;
151
+ }>;
152
+ deviation: z.ZodObject<{
153
+ N: z.ZodNumber;
154
+ P2O5: z.ZodNumber;
155
+ K2O: z.ZodNumber;
156
+ CaO: z.ZodNumber;
157
+ MgO: z.ZodNumber;
158
+ }, "strip", z.ZodTypeAny, {
159
+ N: number;
160
+ P2O5: number;
161
+ K2O: number;
162
+ CaO: number;
163
+ MgO: number;
164
+ }, {
165
+ N: number;
166
+ P2O5: number;
167
+ K2O: number;
168
+ CaO: number;
169
+ MgO: number;
170
+ }>;
171
+ fertilizerSet: z.ZodObject<{
172
+ id: z.ZodString;
173
+ name: z.ZodString;
174
+ }, "strip", z.ZodTypeAny, {
175
+ id: string;
176
+ name: string;
177
+ }, {
178
+ id: string;
179
+ name: string;
180
+ }>;
181
+ weeklyProducts: z.ZodArray<z.ZodObject<{
182
+ productId: z.ZodString;
183
+ name: z.ZodString;
184
+ drum: z.ZodEnum<["A", "B"]>;
185
+ gramsPerPlantPerWeek: z.ZodNumber;
186
+ fieldKgPerWeek: z.ZodNullable<z.ZodNumber>;
187
+ }, "strip", z.ZodTypeAny, {
188
+ name: string;
189
+ productId: string;
190
+ drum: "A" | "B";
191
+ gramsPerPlantPerWeek: number;
192
+ fieldKgPerWeek: number | null;
193
+ }, {
194
+ name: string;
195
+ productId: string;
196
+ drum: "A" | "B";
197
+ gramsPerPlantPerWeek: number;
198
+ fieldKgPerWeek: number | null;
199
+ }>, "many">;
200
+ drumFeedsPerWeek: z.ZodObject<{
201
+ A: z.ZodNumber;
202
+ B: z.ZodNumber;
203
+ }, "strip", z.ZodTypeAny, {
204
+ A: number;
205
+ B: number;
206
+ }, {
207
+ A: number;
208
+ B: number;
209
+ }>;
210
+ feeds: z.ZodArray<z.ZodObject<{
211
+ productId: z.ZodString;
212
+ name: z.ZodString;
213
+ drum: z.ZodEnum<["A", "B"]>;
214
+ gramsPerPlantPerFeed: z.ZodNumber;
215
+ fieldKgPerFeed: z.ZodNullable<z.ZodNumber>;
216
+ }, "strip", z.ZodTypeAny, {
217
+ name: string;
218
+ productId: string;
219
+ drum: "A" | "B";
220
+ gramsPerPlantPerFeed: number;
221
+ fieldKgPerFeed: number | null;
222
+ }, {
223
+ name: string;
224
+ productId: string;
225
+ drum: "A" | "B";
226
+ gramsPerPlantPerFeed: number;
227
+ fieldKgPerFeed: number | null;
228
+ }>, "many">;
229
+ water: z.ZodObject<{
230
+ kc: z.ZodNumber;
231
+ etoMmPerDay: z.ZodNumber;
232
+ etoAssumed: z.ZodBoolean;
233
+ plantsPerHectare: z.ZodNumber;
234
+ plantsAssumed: z.ZodBoolean;
235
+ etcMm: z.ZodNumber;
236
+ litresPerPlantPerDay: z.ZodNumber;
237
+ fieldLitresPerDay: z.ZodNullable<z.ZodNumber>;
238
+ notes: z.ZodArray<z.ZodString, "many">;
239
+ }, "strip", z.ZodTypeAny, {
240
+ notes: string[];
241
+ kc: number;
242
+ etoMmPerDay: number;
243
+ etoAssumed: boolean;
244
+ plantsPerHectare: number;
245
+ plantsAssumed: boolean;
246
+ etcMm: number;
247
+ litresPerPlantPerDay: number;
248
+ fieldLitresPerDay: number | null;
249
+ }, {
250
+ notes: string[];
251
+ kc: number;
252
+ etoMmPerDay: number;
253
+ etoAssumed: boolean;
254
+ plantsPerHectare: number;
255
+ plantsAssumed: boolean;
256
+ etcMm: number;
257
+ litresPerPlantPerDay: number;
258
+ fieldLitresPerDay: number | null;
259
+ }>;
260
+ blockers: z.ZodArray<z.ZodString, "many">;
261
+ warnings: z.ZodArray<z.ZodString, "many">;
262
+ notices: z.ZodArray<z.ZodString, "many">;
263
+ cautions: z.ZodArray<z.ZodString, "many">;
264
+ notes: z.ZodArray<z.ZodString, "many">;
265
+ }, "strip", z.ZodTypeAny, {
266
+ notes: string[];
267
+ stage: {
268
+ id: string;
269
+ label: string;
270
+ railLabel: string;
271
+ dayStart: number;
272
+ dayEnd: number;
273
+ };
274
+ water: {
275
+ notes: string[];
276
+ kc: number;
277
+ etoMmPerDay: number;
278
+ etoAssumed: boolean;
279
+ plantsPerHectare: number;
280
+ plantsAssumed: boolean;
281
+ etcMm: number;
282
+ litresPerPlantPerDay: number;
283
+ fieldLitresPerDay: number | null;
284
+ };
285
+ sheet: {
286
+ id: string;
287
+ summary: string;
288
+ label: string;
289
+ version: number;
290
+ evidenceLevel: "A" | "B" | "C";
291
+ approvedBy: string;
292
+ approvedAt: string;
293
+ yieldBasis: string;
294
+ };
295
+ fieldDay: number;
296
+ yieldTargetKgPerPlant: number;
297
+ feedIntensity: number;
298
+ plantCount: number | null;
299
+ weeklyPerPlantG: {
300
+ N: number;
301
+ P2O5: number;
302
+ K2O: number;
303
+ CaO: number;
304
+ MgO: number;
305
+ };
306
+ weeklyFieldKg: {
307
+ N: number;
308
+ P2O5: number;
309
+ K2O: number;
310
+ CaO: number;
311
+ MgO: number;
312
+ } | null;
313
+ deliveredPerPlantG: {
314
+ N: number;
315
+ P2O5: number;
316
+ K2O: number;
317
+ CaO: number;
318
+ MgO: number;
319
+ };
320
+ deviation: {
321
+ N: number;
322
+ P2O5: number;
323
+ K2O: number;
324
+ CaO: number;
325
+ MgO: number;
326
+ };
327
+ fertilizerSet: {
328
+ id: string;
329
+ name: string;
330
+ };
331
+ weeklyProducts: {
332
+ name: string;
333
+ productId: string;
334
+ drum: "A" | "B";
335
+ gramsPerPlantPerWeek: number;
336
+ fieldKgPerWeek: number | null;
337
+ }[];
338
+ drumFeedsPerWeek: {
339
+ A: number;
340
+ B: number;
341
+ };
342
+ feeds: {
343
+ name: string;
344
+ productId: string;
345
+ drum: "A" | "B";
346
+ gramsPerPlantPerFeed: number;
347
+ fieldKgPerFeed: number | null;
348
+ }[];
349
+ blockers: string[];
350
+ warnings: string[];
351
+ notices: string[];
352
+ cautions: string[];
353
+ }, {
354
+ notes: string[];
355
+ stage: {
356
+ id: string;
357
+ label: string;
358
+ railLabel: string;
359
+ dayStart: number;
360
+ dayEnd: number;
361
+ };
362
+ water: {
363
+ notes: string[];
364
+ kc: number;
365
+ etoMmPerDay: number;
366
+ etoAssumed: boolean;
367
+ plantsPerHectare: number;
368
+ plantsAssumed: boolean;
369
+ etcMm: number;
370
+ litresPerPlantPerDay: number;
371
+ fieldLitresPerDay: number | null;
372
+ };
373
+ sheet: {
374
+ id: string;
375
+ summary: string;
376
+ label: string;
377
+ version: number;
378
+ evidenceLevel: "A" | "B" | "C";
379
+ approvedBy: string;
380
+ approvedAt: string;
381
+ yieldBasis: string;
382
+ };
383
+ fieldDay: number;
384
+ yieldTargetKgPerPlant: number;
385
+ feedIntensity: number;
386
+ plantCount: number | null;
387
+ weeklyPerPlantG: {
388
+ N: number;
389
+ P2O5: number;
390
+ K2O: number;
391
+ CaO: number;
392
+ MgO: number;
393
+ };
394
+ weeklyFieldKg: {
395
+ N: number;
396
+ P2O5: number;
397
+ K2O: number;
398
+ CaO: number;
399
+ MgO: number;
400
+ } | null;
401
+ deliveredPerPlantG: {
402
+ N: number;
403
+ P2O5: number;
404
+ K2O: number;
405
+ CaO: number;
406
+ MgO: number;
407
+ };
408
+ deviation: {
409
+ N: number;
410
+ P2O5: number;
411
+ K2O: number;
412
+ CaO: number;
413
+ MgO: number;
414
+ };
415
+ fertilizerSet: {
416
+ id: string;
417
+ name: string;
418
+ };
419
+ weeklyProducts: {
420
+ name: string;
421
+ productId: string;
422
+ drum: "A" | "B";
423
+ gramsPerPlantPerWeek: number;
424
+ fieldKgPerWeek: number | null;
425
+ }[];
426
+ drumFeedsPerWeek: {
427
+ A: number;
428
+ B: number;
429
+ };
430
+ feeds: {
431
+ name: string;
432
+ productId: string;
433
+ drum: "A" | "B";
434
+ gramsPerPlantPerFeed: number;
435
+ fieldKgPerFeed: number | null;
436
+ }[];
437
+ blockers: string[];
438
+ warnings: string[];
439
+ notices: string[];
440
+ cautions: string[];
441
+ }>>;
442
+ generatedAt: z.ZodString;
443
+ }, "strip", z.ZodTypeAny, {
444
+ status: "ok" | "unsupported-crop" | "not-transplanted";
445
+ message: string | null;
446
+ crop: string | null;
447
+ fieldId: string;
448
+ generatedAt: string;
449
+ plan: {
450
+ notes: string[];
451
+ stage: {
452
+ id: string;
453
+ label: string;
454
+ railLabel: string;
455
+ dayStart: number;
456
+ dayEnd: number;
457
+ };
458
+ water: {
459
+ notes: string[];
460
+ kc: number;
461
+ etoMmPerDay: number;
462
+ etoAssumed: boolean;
463
+ plantsPerHectare: number;
464
+ plantsAssumed: boolean;
465
+ etcMm: number;
466
+ litresPerPlantPerDay: number;
467
+ fieldLitresPerDay: number | null;
468
+ };
469
+ sheet: {
470
+ id: string;
471
+ summary: string;
472
+ label: string;
473
+ version: number;
474
+ evidenceLevel: "A" | "B" | "C";
475
+ approvedBy: string;
476
+ approvedAt: string;
477
+ yieldBasis: string;
478
+ };
479
+ fieldDay: number;
480
+ yieldTargetKgPerPlant: number;
481
+ feedIntensity: number;
482
+ plantCount: number | null;
483
+ weeklyPerPlantG: {
484
+ N: number;
485
+ P2O5: number;
486
+ K2O: number;
487
+ CaO: number;
488
+ MgO: number;
489
+ };
490
+ weeklyFieldKg: {
491
+ N: number;
492
+ P2O5: number;
493
+ K2O: number;
494
+ CaO: number;
495
+ MgO: number;
496
+ } | null;
497
+ deliveredPerPlantG: {
498
+ N: number;
499
+ P2O5: number;
500
+ K2O: number;
501
+ CaO: number;
502
+ MgO: number;
503
+ };
504
+ deviation: {
505
+ N: number;
506
+ P2O5: number;
507
+ K2O: number;
508
+ CaO: number;
509
+ MgO: number;
510
+ };
511
+ fertilizerSet: {
512
+ id: string;
513
+ name: string;
514
+ };
515
+ weeklyProducts: {
516
+ name: string;
517
+ productId: string;
518
+ drum: "A" | "B";
519
+ gramsPerPlantPerWeek: number;
520
+ fieldKgPerWeek: number | null;
521
+ }[];
522
+ drumFeedsPerWeek: {
523
+ A: number;
524
+ B: number;
525
+ };
526
+ feeds: {
527
+ name: string;
528
+ productId: string;
529
+ drum: "A" | "B";
530
+ gramsPerPlantPerFeed: number;
531
+ fieldKgPerFeed: number | null;
532
+ }[];
533
+ blockers: string[];
534
+ warnings: string[];
535
+ notices: string[];
536
+ cautions: string[];
537
+ } | null;
538
+ }, {
539
+ status: "ok" | "unsupported-crop" | "not-transplanted";
540
+ message: string | null;
541
+ crop: string | null;
542
+ fieldId: string;
543
+ generatedAt: string;
544
+ plan: {
545
+ notes: string[];
546
+ stage: {
547
+ id: string;
548
+ label: string;
549
+ railLabel: string;
550
+ dayStart: number;
551
+ dayEnd: number;
552
+ };
553
+ water: {
554
+ notes: string[];
555
+ kc: number;
556
+ etoMmPerDay: number;
557
+ etoAssumed: boolean;
558
+ plantsPerHectare: number;
559
+ plantsAssumed: boolean;
560
+ etcMm: number;
561
+ litresPerPlantPerDay: number;
562
+ fieldLitresPerDay: number | null;
563
+ };
564
+ sheet: {
565
+ id: string;
566
+ summary: string;
567
+ label: string;
568
+ version: number;
569
+ evidenceLevel: "A" | "B" | "C";
570
+ approvedBy: string;
571
+ approvedAt: string;
572
+ yieldBasis: string;
573
+ };
574
+ fieldDay: number;
575
+ yieldTargetKgPerPlant: number;
576
+ feedIntensity: number;
577
+ plantCount: number | null;
578
+ weeklyPerPlantG: {
579
+ N: number;
580
+ P2O5: number;
581
+ K2O: number;
582
+ CaO: number;
583
+ MgO: number;
584
+ };
585
+ weeklyFieldKg: {
586
+ N: number;
587
+ P2O5: number;
588
+ K2O: number;
589
+ CaO: number;
590
+ MgO: number;
591
+ } | null;
592
+ deliveredPerPlantG: {
593
+ N: number;
594
+ P2O5: number;
595
+ K2O: number;
596
+ CaO: number;
597
+ MgO: number;
598
+ };
599
+ deviation: {
600
+ N: number;
601
+ P2O5: number;
602
+ K2O: number;
603
+ CaO: number;
604
+ MgO: number;
605
+ };
606
+ fertilizerSet: {
607
+ id: string;
608
+ name: string;
609
+ };
610
+ weeklyProducts: {
611
+ name: string;
612
+ productId: string;
613
+ drum: "A" | "B";
614
+ gramsPerPlantPerWeek: number;
615
+ fieldKgPerWeek: number | null;
616
+ }[];
617
+ drumFeedsPerWeek: {
618
+ A: number;
619
+ B: number;
620
+ };
621
+ feeds: {
622
+ name: string;
623
+ productId: string;
624
+ drum: "A" | "B";
625
+ gramsPerPlantPerFeed: number;
626
+ fieldKgPerFeed: number | null;
627
+ }[];
628
+ blockers: string[];
629
+ warnings: string[];
630
+ notices: string[];
631
+ cautions: string[];
632
+ } | null;
633
+ }>;
634
+ 400: z.ZodObject<{
635
+ message: z.ZodString;
636
+ }, "strip", z.ZodTypeAny, {
637
+ message: string;
638
+ }, {
639
+ message: string;
640
+ }>;
641
+ 404: z.ZodObject<{
642
+ message: z.ZodString;
643
+ }, "strip", z.ZodTypeAny, {
644
+ message: string;
645
+ }, {
646
+ message: string;
647
+ }>;
648
+ };
649
+ };
650
+ };
651
+ //# sourceMappingURL=nutrient-plan.routes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nutrient-plan.routes.d.ts","sourceRoot":"","sources":["../../src/routes/nutrient-plan.routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;YAazB,6EAA6E;;YAE7E,wFAAwF;;YAExF,kDAAkD;;YAKlD,gFAAgF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAapF,CAAC"}
@@ -0,0 +1,40 @@
1
+ import { initContract } from '@ts-rest/core';
2
+ import { z } from 'zod';
3
+ import { nutrientPlanResponseSchema } from '../schemas/nutrient-plan.schemas';
4
+ const c = initContract();
5
+ export const nutrientPlanRouter = c.router({
6
+ /**
7
+ * The field's fertigation plan for today's growth stage: grams of each nutrient and product per plant per
8
+ * week and per feed, a water budget, and the guardrail verdict. Deterministic; does not call a model.
9
+ */
10
+ forField: {
11
+ method: 'GET',
12
+ path: '/farms/:farmId/fields/:fieldId/nutrient-plan',
13
+ pathParams: z.object({
14
+ farmId: z.string().min(1),
15
+ fieldId: z.string().min(1),
16
+ }),
17
+ query: z.object({
18
+ /** Target kg of fresh fruit per plant; clamped to the crop sheet's range. */
19
+ yieldTarget: z.coerce.number().positive().max(20).optional(),
20
+ /** One of the fertilizer sets, e.g. kno3-agrovert, agrovert-range, standard-soluble. */
21
+ fertilizerSet: z.string().min(1).max(60).optional(),
22
+ /** True when the beds are under plastic mulch. */
23
+ mulched: z
24
+ .enum(['true', 'false'])
25
+ .transform((value) => value === 'true')
26
+ .optional(),
27
+ /** Client calendar date (YYYY-MM-DD), so the stage matches the farmer's day. */
28
+ today: z
29
+ .string()
30
+ .regex(/^\d{4}-\d{2}-\d{2}/)
31
+ .optional(),
32
+ }),
33
+ responses: {
34
+ 200: nutrientPlanResponseSchema,
35
+ 400: z.object({ message: z.string() }),
36
+ 404: z.object({ message: z.string() }),
37
+ },
38
+ summary: 'Per-plant fertigation plan for a field at its current growth stage',
39
+ },
40
+ });