devcontour-harness 0.1.0-alpha.31 → 0.1.0-alpha.34

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 (55) hide show
  1. package/README.md +22 -3
  2. package/docs/architecture.md +12 -0
  3. package/docs/compatibility.md +21 -18
  4. package/docs/contracts.md +135 -13
  5. package/docs/release-notes/0.1.0-alpha.32.md +33 -0
  6. package/docs/release-notes/0.1.0-alpha.33.md +29 -0
  7. package/docs/release-notes/0.1.0-alpha.34.md +32 -0
  8. package/docs/upgrade.md +137 -0
  9. package/lib/cli.js +2 -2
  10. package/lib/contracts/cli.d.ts +295 -5
  11. package/lib/contracts/events.d.ts +350 -4
  12. package/lib/contracts/events.js +63 -2
  13. package/lib/contracts/failure.d.ts +6 -1
  14. package/lib/contracts/failure.js +5 -1
  15. package/lib/contracts/handoff.d.ts +8 -0
  16. package/lib/contracts/handoff.js +17 -3
  17. package/lib/contracts/published.d.ts +177 -3
  18. package/lib/contracts/report.d.ts +116 -2
  19. package/lib/contracts/report.js +61 -3
  20. package/lib/control/base-move.d.ts +7 -2
  21. package/lib/control/base-move.js +14 -1
  22. package/lib/control/harness.d.ts +44 -8
  23. package/lib/control/harness.js +8 -96
  24. package/lib/control/status.d.ts +235 -0
  25. package/lib/control/status.js +101 -0
  26. package/lib/engine/budget.d.ts +78 -0
  27. package/lib/engine/budget.js +13 -2
  28. package/lib/engine/classify.d.ts +14 -1
  29. package/lib/engine/classify.js +34 -0
  30. package/lib/engine/engine.d.ts +17 -5
  31. package/lib/engine/engine.js +75 -5
  32. package/lib/engine/runner.js +4 -5
  33. package/lib/environment/isolation.d.ts +67 -3
  34. package/lib/environment/isolation.js +148 -5
  35. package/lib/environment/lifecycle.js +1 -1
  36. package/lib/explain/state.d.ts +25 -4
  37. package/lib/explain/state.js +29 -0
  38. package/lib/handoff/index.d.ts +1 -1
  39. package/lib/handoff/markdown.js +4 -2
  40. package/lib/handoff/pack.d.ts +38 -8
  41. package/lib/handoff/pack.js +57 -18
  42. package/lib/index.d.ts +18 -3
  43. package/lib/index.js +18 -2
  44. package/lib/integrations/connector/testing.js +1 -1
  45. package/lib/projections/next.d.ts +3 -1
  46. package/lib/projections/next.js +4 -1
  47. package/lib/projections/stop.d.ts +11 -0
  48. package/lib/projections/stop.js +44 -15
  49. package/lib/report/compute.js +228 -21
  50. package/lib/report/document.js +31 -7
  51. package/lib/verification/gates.js +20 -4
  52. package/package.json +1 -1
  53. package/schemas/handoff-pack.schema.json +6 -0
  54. package/schemas/run-event.schema.json +319 -0
  55. package/schemas/value-report.schema.json +235 -3
package/docs/upgrade.md CHANGED
@@ -357,6 +357,143 @@ install|fetch` или `yarn install`;
357
357
  **Откат.** Ниже этой версии команды `handoff` нет; состояние она не меняла,
358
358
  поэтому откат пакета копии не требует.
359
359
 
360
+ ### alpha.32: пакет передачи контекста для хоста
361
+
362
+ Только чтение и только аддитивно: формат состояния, политики, событий и
363
+ `HandoffPack` (`handoffVersion: 1`, `schemas/handoff-pack.schema.json`) не
364
+ меняется. Новое в корне пакета:
365
+
366
+ - `handoffPack(source, options)` принимает `HandoffSource`
367
+ (`{ engine, policy, workflows: { list, continues } }`) — `Harness` ему
368
+ удовлетворяет, прежние вызовы не меняются; хосту со своим `Engine` больше
369
+ не нужен экземпляр `Harness`. `statusOf(source, graphId?, { detail })` —
370
+ состояние доски над движком и политикой (`Harness.status` вызывает её же),
371
+ типы `HandoffSource`, `StatusSource`, `StopSource` (`stopInputsOf`
372
+ принимает тот же источник).
373
+ - Параметры `maxBytes` (от `HANDOFF_MIN_BYTES` = 4096 до `HANDOFF_MAX_BYTES`)
374
+ и `measure` (`json` | `markdown`) — тот же порядок отбрасывания под
375
+ меньший предел ответа хоста.
376
+ - `policySecrets(policy, env?)` экспортирован: маску хоста можно составить
377
+ из секретов политики тем же обходом (`composeRedactors`).
378
+
379
+ Строка Markdown об урезании теперь «Пакет урезан по пределу размера» без
380
+ числа: предел задаёт вызывающий.
381
+
382
+ **Откат.** Состояние не меняется, копия не нужна. Хост, вызвавший
383
+ `handoffPack` с узким источником, `maxBytes` или `measure`, либо
384
+ импортировавший `statusOf`, `policySecrets` или `HANDOFF_MIN_BYTES`, при
385
+ откате возвращается к прежнему коду (экземпляр `Harness`, свой обход
386
+ секретов и своя подгонка размера).
387
+
388
+ ### alpha.32: запись файла отчёта для хоста
389
+
390
+ Только аддитивно: форматы не меняются. Из корня пакета экспортированы
391
+ `writeReportFile(out, stateDir, text)`, `REPORT_FILE_MODE` и тип
392
+ `ReportFileIo` — та же запись, что у `harness report --out`. В
393
+ `devcontour-harness/report` её нет: модуль остаётся без `node:*`.
394
+
395
+ **Откат.** Состояние не меняется. Хост, импортировавший `writeReportFile`,
396
+ при откате возвращается к своей копии записи.
397
+
398
+ ### alpha.32: песочница при глубоком TMPDIR
399
+
400
+ Форматы не меняются. Раньше при глубоком TMPDIR процесса controller путь
401
+ unix-сокета sandbox-runtime превышал предел (104 байта на macOS, 108 на
402
+ Linux), srt падал до запуска команды (`listen EINVAL`), и проверка не
403
+ стартовала. Теперь srt в этом случае получает короткий каталог
404
+ `/tmp/dc-srt-<pid>-*` (`0700`, удаляется после проверки; брошенные упавшим controller каталоги, где ничего не менялось дольше суток и процесса создателя нет, убираются при создании нового). Если и он недоступен —
405
+ отказ среды (`environment`) с TMPDIR в тексте.
406
+
407
+ **Откат.** Состояние не меняется. На прежней версии при глубоком TMPDIR
408
+ проверки в песочнице снова не стартуют: задайте короткий TMPDIR.
409
+
410
+ ### alpha.33: отменённые без ждущих и расход ревью плана в пакете передачи
411
+
412
+ Форматы состояния, политики и событий прежние; `handoffVersion` — 1.
413
+
414
+ - Отменённая работа (и упавшая с классом `cancelled`) — решение ведущего
415
+ (`CANCELLED`, `replan-dependents`), только пока от неё прямо зависит
416
+ незавершённая работа (не `done` и не `cancelled`); сообщение называет
417
+ ждущих. Отменённая без таких работ в общий `explain` и в `stops`/`next`
418
+ пакета передачи не входит (как принятая); `explain --work` этой работы
419
+ показывает её с `action: none`. Упавшая отменой без ждущих — решение
420
+ человека (user `user-decision`: `harness retry` или отмена), а не повтор:
421
+ `nextAction` для неё — `user-decision` на шаге `cancelled`. Диагноз упавшей
422
+ работы, чью группу движок не восстанавливает из-за отмены, называет
423
+ отменённую.
424
+ Раньше доска, где все зависимые отменённых тоже отменены или приняты,
425
+ начиналась с решения «перепланировать», которое нечего было делать.
426
+ - Вызов о группе (ревью и проверка плана) по-прежнему засчитывается целиком
427
+ бюджету каждого её открытого поручения — так действует ограничение
428
+ поручения; в строках группы и `total` он учтён один раз, суммы не
429
+ завышены. Пакет передачи больше не перечисляет бюджеты поручений, весь
430
+ расход которых — такие вызовы, кроме тех, что держат выдачу (превышены
431
+ или не определены при `onUnknown: stop`): их число — новое поле
432
+ `truncated.budgetsShared` (в схеме необязательное, по умолчанию 0: пакеты
433
+ прежних версий разбираются). `handoffVersion` остаётся 1, поэтому внешний
434
+ валидатор со строгой прежней схемой пакета
435
+ (`schemas/handoff-pack.schema.json`) обновляется вместе с harness: прежняя
436
+ схема новое поле отклонит. `status` бюджеты поручений показывает как
437
+ прежде.
438
+
439
+ **Откат.** Состояние не меняется; прежняя версия снова показывает такие
440
+ отменённые как решение и повторяет строку бюджета у каждого поручения.
441
+
442
+ ### alpha.34: события вмешательств и причин отказа
443
+
444
+ Формат состояния (`stateVersion: 1`), политики и её digest прежние: в документ
445
+ состояния не добавлено ни одного поля. Новое в журнале (`docs/contracts.md`,
446
+ `RunEvent`):
447
+
448
+ - `work.retried {by, reset, spent?, reasonLength?}` — повтор поручения.
449
+ `engine.retry(workId, reset?, by?)` принимает актёра: CLI `retry` —
450
+ `operator`, восстановление очереди — `recovery`, по умолчанию `host`.
451
+ Текста причины сброса в событии нет, только длина.
452
+ - `work.cancelled {by, hadAttempt}` — отмена поручения, в том числе без
453
+ активной попытки и новой редакцией графа (`by: graph`).
454
+ `engine.cancel(workId, reason?, by?)`; CLI `cancel` — `operator`.
455
+ - `base.moved {by}` — сдвиг ref базы `fencedRefMove(store, fence, timeoutMs?,
456
+ by?)`, `by` — `operator`, `controller` или `host` (по умолчанию). Хост,
457
+ сдвигающий базу перемоткой очереди, передаёт `controller`, ручной перенос —
458
+ `operator`. Транзакция `base.moved` теперь пишет событие: адаптер хоста,
459
+ выполнявший её без событий, должен записать его так же, как другие
460
+ нейтральные события без изменения документа.
461
+ - `attempt.diagnosed {failureKind, cause, counted}` — причина отказа попытки
462
+ рядом с `attempt.failed` и `attempt.expired`. Хост, вызывающий
463
+ `engine.fail` сам, может передать `options.cause`; `TaskFailure` принимает
464
+ причину четвёртым аргументом (`diagnosis`).
465
+
466
+ Отчёт (`ValueReport`, `reportVersion: 1`): `autonomy.actions.recorded`
467
+ (актёры вмешательств по событиям или `null`), суммы `retries`/`resets` по
468
+ событиям — только точные (иначе `null`), `baseMoves` — всегда `null` (сдвиг
469
+ вне `fencedRefMove` не пишется, число по актёрам — нижняя граница),
470
+ `withAction`/`withoutAction` с записью — точные или нижняя граница
471
+ (удержанные поручения — неизвестны); `environment.causes` — подпричины или
472
+ `null`; предел `limitations` — 40. Засчитанные попытки (первая попытка,
473
+ попыток на принятое) считаются по правилу движка: зависание (`stalled`)
474
+ теперь засчитано. Без новых событий отчёт прежний, кроме поля `recorded:
475
+ null` и этого правила засчитанных попыток: история с зависаниями даёт
476
+ другие числа первой попытки и попыток на принятое. Читатель, проверявший отчёт
477
+ строгой схемой прежней версии, отклонит новое поле и непустые `causes`:
478
+ обновить схему вместе с пакетом.
479
+
480
+ **Откат.** Версии с терпимым чтением событий (alpha.30 – alpha.33) читают
481
+ новые события как `{type: 'unknown', original}` без нагрузки: очередь,
482
+ `status`, `result`, `events` и `report` работают, а отчёт снова показывает
483
+ вмешательства как «не записано». Ниже alpha.30 `harness events` и чтение
484
+ журнала хостом отказывают на первой странице с новым событием — путь тот же,
485
+ что для `attempt.stage` (alpha.30): восстановить копию каталога состояния,
486
+ снятую до обновления. Удалять или переписывать события ради отката нельзя.
487
+ Хост, передававший `by` в `retry`, `cancel` или `fencedRefMove`, при откате
488
+ убирает аргумент (прежние версии его игнорируют только в JavaScript без
489
+ проверки типов).
490
+
491
+ Откат с последующим повторным обновлением оставляет пробел записи: повторы,
492
+ отмены и сдвиги базы, сделанные прежней версией, событий не имеют. Отчёт
493
+ находит пробел, только если он оставил новую попытку после отказа или отмены
494
+ без записанного повтора (`recorded.gaps`, ограничение `recording-gap`); иной
495
+ пробел не виден, и отчёт всегда называет это ограничением (`rollback-gap`).
496
+
360
497
  ## Перед обновлением
361
498
 
362
499
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
package/lib/cli.js CHANGED
@@ -477,8 +477,8 @@ async function run(argv) {
477
477
  data: await h.deliver(need('work'), sinkOf(need('sink'), h, b.baseDir)),
478
478
  };
479
479
  const result = command === 'cancel'
480
- ? h.engine.cancel(need('work'), v.reason)
481
- : h.engine.retry(need('work'), v.reset ? { reason: need('reason') } : undefined);
480
+ ? h.engine.cancel(need('work'), v.reason, 'operator')
481
+ : h.engine.retry(need('work'), v.reset ? { reason: need('reason') } : undefined, 'operator');
482
482
  return {
483
483
  command,
484
484
  data: {
@@ -1091,7 +1091,7 @@ export declare const eventsDataSchema: z.ZodObject<{
1091
1091
  workId: z.ZodOptional<z.ZodString>;
1092
1092
  runId: z.ZodOptional<z.ZodString>;
1093
1093
  attempt: z.ZodOptional<z.ZodNumber>;
1094
- type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
1094
+ type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
1095
1095
  payload: z.ZodObject<{
1096
1096
  digest: z.ZodString;
1097
1097
  orders: z.ZodNumber;
@@ -1253,6 +1253,42 @@ export declare const eventsDataSchema: z.ZodObject<{
1253
1253
  }>;
1254
1254
  message: z.ZodString;
1255
1255
  blocked: z.ZodBoolean;
1256
+ }, z.core.$strict> | z.ZodObject<{
1257
+ failureKind: z.ZodEnum<{
1258
+ gate: "gate";
1259
+ unknown: "unknown";
1260
+ review: "review";
1261
+ cancelled: "cancelled";
1262
+ environment: "environment";
1263
+ timeout: "timeout";
1264
+ "provider-auth": "provider-auth";
1265
+ stalled: "stalled";
1266
+ "stale-base": "stale-base";
1267
+ "empty-result": "empty-result";
1268
+ unfinished: "unfinished";
1269
+ "scope-violation": "scope-violation";
1270
+ "review-protocol": "review-protocol";
1271
+ merge: "merge";
1272
+ budget: "budget";
1273
+ "needs-lead": "needs-lead";
1274
+ }>;
1275
+ cause: z.ZodEnum<{
1276
+ preflight: "preflight";
1277
+ transport: "transport";
1278
+ none: "none";
1279
+ other: "other";
1280
+ "provider-auth": "provider-auth";
1281
+ stalled: "stalled";
1282
+ shutdown: "shutdown";
1283
+ "sandbox-launch": "sandbox-launch";
1284
+ "sandbox-network": "sandbox-network";
1285
+ "sandbox-filesystem": "sandbox-filesystem";
1286
+ "sandbox-policy": "sandbox-policy";
1287
+ "dependency-network": "dependency-network";
1288
+ "provider-limit": "provider-limit";
1289
+ "lease-expired": "lease-expired";
1290
+ }>;
1291
+ counted: z.ZodBoolean;
1256
1292
  }, z.core.$strict> | z.ZodObject<{
1257
1293
  leaseUntil: z.ZodNumber;
1258
1294
  }, z.core.$strict> | z.ZodObject<{
@@ -1264,6 +1300,22 @@ export declare const eventsDataSchema: z.ZodObject<{
1264
1300
  }, z.core.$strict> | z.ZodObject<{
1265
1301
  resultSha: z.ZodString;
1266
1302
  integrationSha: z.ZodString;
1303
+ }, z.core.$strict> | z.ZodObject<{
1304
+ by: z.ZodEnum<{
1305
+ operator: "operator";
1306
+ recovery: "recovery";
1307
+ host: "host";
1308
+ }>;
1309
+ reset: z.ZodBoolean;
1310
+ spent: z.ZodOptional<z.ZodNumber>;
1311
+ reasonLength: z.ZodOptional<z.ZodNumber>;
1312
+ }, z.core.$strict> | z.ZodObject<{
1313
+ by: z.ZodEnum<{
1314
+ operator: "operator";
1315
+ graph: "graph";
1316
+ host: "host";
1317
+ }>;
1318
+ hadAttempt: z.ZodBoolean;
1267
1319
  }, z.core.$strict> | z.ZodObject<{
1268
1320
  code: z.ZodString;
1269
1321
  message: z.ZodString;
@@ -1303,6 +1355,12 @@ export declare const eventsDataSchema: z.ZodObject<{
1303
1355
  }>;
1304
1356
  }, z.core.$strict> | z.ZodObject<{
1305
1357
  owner: z.ZodString;
1358
+ }, z.core.$strict> | z.ZodObject<{
1359
+ by: z.ZodEnum<{
1360
+ operator: "operator";
1361
+ controller: "controller";
1362
+ host: "host";
1363
+ }>;
1306
1364
  }, z.core.$strict> | z.ZodObject<{
1307
1365
  owner: z.ZodString;
1308
1366
  }, z.core.$strict> | z.ZodObject<{
@@ -1445,7 +1503,7 @@ export declare const eventsDataSchema: z.ZodObject<{
1445
1503
  workId: z.ZodOptional<z.ZodString>;
1446
1504
  runId: z.ZodOptional<z.ZodString>;
1447
1505
  attempt: z.ZodOptional<z.ZodNumber>;
1448
- type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
1506
+ type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
1449
1507
  payload: z.ZodObject<{
1450
1508
  digest: z.ZodString;
1451
1509
  orders: z.ZodNumber;
@@ -1607,6 +1665,42 @@ export declare const eventsDataSchema: z.ZodObject<{
1607
1665
  }>;
1608
1666
  message: z.ZodString;
1609
1667
  blocked: z.ZodBoolean;
1668
+ }, z.core.$strict> | z.ZodObject<{
1669
+ failureKind: z.ZodEnum<{
1670
+ gate: "gate";
1671
+ unknown: "unknown";
1672
+ review: "review";
1673
+ cancelled: "cancelled";
1674
+ environment: "environment";
1675
+ timeout: "timeout";
1676
+ "provider-auth": "provider-auth";
1677
+ stalled: "stalled";
1678
+ "stale-base": "stale-base";
1679
+ "empty-result": "empty-result";
1680
+ unfinished: "unfinished";
1681
+ "scope-violation": "scope-violation";
1682
+ "review-protocol": "review-protocol";
1683
+ merge: "merge";
1684
+ budget: "budget";
1685
+ "needs-lead": "needs-lead";
1686
+ }>;
1687
+ cause: z.ZodEnum<{
1688
+ preflight: "preflight";
1689
+ transport: "transport";
1690
+ none: "none";
1691
+ other: "other";
1692
+ "provider-auth": "provider-auth";
1693
+ stalled: "stalled";
1694
+ shutdown: "shutdown";
1695
+ "sandbox-launch": "sandbox-launch";
1696
+ "sandbox-network": "sandbox-network";
1697
+ "sandbox-filesystem": "sandbox-filesystem";
1698
+ "sandbox-policy": "sandbox-policy";
1699
+ "dependency-network": "dependency-network";
1700
+ "provider-limit": "provider-limit";
1701
+ "lease-expired": "lease-expired";
1702
+ }>;
1703
+ counted: z.ZodBoolean;
1610
1704
  }, z.core.$strict> | z.ZodObject<{
1611
1705
  leaseUntil: z.ZodNumber;
1612
1706
  }, z.core.$strict> | z.ZodObject<{
@@ -1618,6 +1712,22 @@ export declare const eventsDataSchema: z.ZodObject<{
1618
1712
  }, z.core.$strict> | z.ZodObject<{
1619
1713
  resultSha: z.ZodString;
1620
1714
  integrationSha: z.ZodString;
1715
+ }, z.core.$strict> | z.ZodObject<{
1716
+ by: z.ZodEnum<{
1717
+ operator: "operator";
1718
+ recovery: "recovery";
1719
+ host: "host";
1720
+ }>;
1721
+ reset: z.ZodBoolean;
1722
+ spent: z.ZodOptional<z.ZodNumber>;
1723
+ reasonLength: z.ZodOptional<z.ZodNumber>;
1724
+ }, z.core.$strict> | z.ZodObject<{
1725
+ by: z.ZodEnum<{
1726
+ operator: "operator";
1727
+ graph: "graph";
1728
+ host: "host";
1729
+ }>;
1730
+ hadAttempt: z.ZodBoolean;
1621
1731
  }, z.core.$strict> | z.ZodObject<{
1622
1732
  code: z.ZodString;
1623
1733
  message: z.ZodString;
@@ -1657,6 +1767,12 @@ export declare const eventsDataSchema: z.ZodObject<{
1657
1767
  }>;
1658
1768
  }, z.core.$strict> | z.ZodObject<{
1659
1769
  owner: z.ZodString;
1770
+ }, z.core.$strict> | z.ZodObject<{
1771
+ by: z.ZodEnum<{
1772
+ operator: "operator";
1773
+ controller: "controller";
1774
+ host: "host";
1775
+ }>;
1660
1776
  }, z.core.$strict> | z.ZodObject<{
1661
1777
  owner: z.ZodString;
1662
1778
  }, z.core.$strict> | z.ZodObject<{
@@ -3267,7 +3383,7 @@ export declare const cliDataSchemas: {
3267
3383
  workId: z.ZodOptional<z.ZodString>;
3268
3384
  runId: z.ZodOptional<z.ZodString>;
3269
3385
  attempt: z.ZodOptional<z.ZodNumber>;
3270
- type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
3386
+ type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
3271
3387
  payload: z.ZodObject<{
3272
3388
  digest: z.ZodString;
3273
3389
  orders: z.ZodNumber;
@@ -3429,6 +3545,42 @@ export declare const cliDataSchemas: {
3429
3545
  }>;
3430
3546
  message: z.ZodString;
3431
3547
  blocked: z.ZodBoolean;
3548
+ }, z.core.$strict> | z.ZodObject<{
3549
+ failureKind: z.ZodEnum<{
3550
+ gate: "gate";
3551
+ unknown: "unknown";
3552
+ review: "review";
3553
+ cancelled: "cancelled";
3554
+ environment: "environment";
3555
+ timeout: "timeout";
3556
+ "provider-auth": "provider-auth";
3557
+ stalled: "stalled";
3558
+ "stale-base": "stale-base";
3559
+ "empty-result": "empty-result";
3560
+ unfinished: "unfinished";
3561
+ "scope-violation": "scope-violation";
3562
+ "review-protocol": "review-protocol";
3563
+ merge: "merge";
3564
+ budget: "budget";
3565
+ "needs-lead": "needs-lead";
3566
+ }>;
3567
+ cause: z.ZodEnum<{
3568
+ preflight: "preflight";
3569
+ transport: "transport";
3570
+ none: "none";
3571
+ other: "other";
3572
+ "provider-auth": "provider-auth";
3573
+ stalled: "stalled";
3574
+ shutdown: "shutdown";
3575
+ "sandbox-launch": "sandbox-launch";
3576
+ "sandbox-network": "sandbox-network";
3577
+ "sandbox-filesystem": "sandbox-filesystem";
3578
+ "sandbox-policy": "sandbox-policy";
3579
+ "dependency-network": "dependency-network";
3580
+ "provider-limit": "provider-limit";
3581
+ "lease-expired": "lease-expired";
3582
+ }>;
3583
+ counted: z.ZodBoolean;
3432
3584
  }, z.core.$strict> | z.ZodObject<{
3433
3585
  leaseUntil: z.ZodNumber;
3434
3586
  }, z.core.$strict> | z.ZodObject<{
@@ -3440,6 +3592,22 @@ export declare const cliDataSchemas: {
3440
3592
  }, z.core.$strict> | z.ZodObject<{
3441
3593
  resultSha: z.ZodString;
3442
3594
  integrationSha: z.ZodString;
3595
+ }, z.core.$strict> | z.ZodObject<{
3596
+ by: z.ZodEnum<{
3597
+ operator: "operator";
3598
+ recovery: "recovery";
3599
+ host: "host";
3600
+ }>;
3601
+ reset: z.ZodBoolean;
3602
+ spent: z.ZodOptional<z.ZodNumber>;
3603
+ reasonLength: z.ZodOptional<z.ZodNumber>;
3604
+ }, z.core.$strict> | z.ZodObject<{
3605
+ by: z.ZodEnum<{
3606
+ operator: "operator";
3607
+ graph: "graph";
3608
+ host: "host";
3609
+ }>;
3610
+ hadAttempt: z.ZodBoolean;
3443
3611
  }, z.core.$strict> | z.ZodObject<{
3444
3612
  code: z.ZodString;
3445
3613
  message: z.ZodString;
@@ -3479,6 +3647,12 @@ export declare const cliDataSchemas: {
3479
3647
  }>;
3480
3648
  }, z.core.$strict> | z.ZodObject<{
3481
3649
  owner: z.ZodString;
3650
+ }, z.core.$strict> | z.ZodObject<{
3651
+ by: z.ZodEnum<{
3652
+ operator: "operator";
3653
+ controller: "controller";
3654
+ host: "host";
3655
+ }>;
3482
3656
  }, z.core.$strict> | z.ZodObject<{
3483
3657
  owner: z.ZodString;
3484
3658
  }, z.core.$strict> | z.ZodObject<{
@@ -3621,7 +3795,7 @@ export declare const cliDataSchemas: {
3621
3795
  workId: z.ZodOptional<z.ZodString>;
3622
3796
  runId: z.ZodOptional<z.ZodString>;
3623
3797
  attempt: z.ZodOptional<z.ZodNumber>;
3624
- type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
3798
+ type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
3625
3799
  payload: z.ZodObject<{
3626
3800
  digest: z.ZodString;
3627
3801
  orders: z.ZodNumber;
@@ -3783,6 +3957,42 @@ export declare const cliDataSchemas: {
3783
3957
  }>;
3784
3958
  message: z.ZodString;
3785
3959
  blocked: z.ZodBoolean;
3960
+ }, z.core.$strict> | z.ZodObject<{
3961
+ failureKind: z.ZodEnum<{
3962
+ gate: "gate";
3963
+ unknown: "unknown";
3964
+ review: "review";
3965
+ cancelled: "cancelled";
3966
+ environment: "environment";
3967
+ timeout: "timeout";
3968
+ "provider-auth": "provider-auth";
3969
+ stalled: "stalled";
3970
+ "stale-base": "stale-base";
3971
+ "empty-result": "empty-result";
3972
+ unfinished: "unfinished";
3973
+ "scope-violation": "scope-violation";
3974
+ "review-protocol": "review-protocol";
3975
+ merge: "merge";
3976
+ budget: "budget";
3977
+ "needs-lead": "needs-lead";
3978
+ }>;
3979
+ cause: z.ZodEnum<{
3980
+ preflight: "preflight";
3981
+ transport: "transport";
3982
+ none: "none";
3983
+ other: "other";
3984
+ "provider-auth": "provider-auth";
3985
+ stalled: "stalled";
3986
+ shutdown: "shutdown";
3987
+ "sandbox-launch": "sandbox-launch";
3988
+ "sandbox-network": "sandbox-network";
3989
+ "sandbox-filesystem": "sandbox-filesystem";
3990
+ "sandbox-policy": "sandbox-policy";
3991
+ "dependency-network": "dependency-network";
3992
+ "provider-limit": "provider-limit";
3993
+ "lease-expired": "lease-expired";
3994
+ }>;
3995
+ counted: z.ZodBoolean;
3786
3996
  }, z.core.$strict> | z.ZodObject<{
3787
3997
  leaseUntil: z.ZodNumber;
3788
3998
  }, z.core.$strict> | z.ZodObject<{
@@ -3794,6 +4004,22 @@ export declare const cliDataSchemas: {
3794
4004
  }, z.core.$strict> | z.ZodObject<{
3795
4005
  resultSha: z.ZodString;
3796
4006
  integrationSha: z.ZodString;
4007
+ }, z.core.$strict> | z.ZodObject<{
4008
+ by: z.ZodEnum<{
4009
+ operator: "operator";
4010
+ recovery: "recovery";
4011
+ host: "host";
4012
+ }>;
4013
+ reset: z.ZodBoolean;
4014
+ spent: z.ZodOptional<z.ZodNumber>;
4015
+ reasonLength: z.ZodOptional<z.ZodNumber>;
4016
+ }, z.core.$strict> | z.ZodObject<{
4017
+ by: z.ZodEnum<{
4018
+ operator: "operator";
4019
+ graph: "graph";
4020
+ host: "host";
4021
+ }>;
4022
+ hadAttempt: z.ZodBoolean;
3797
4023
  }, z.core.$strict> | z.ZodObject<{
3798
4024
  code: z.ZodString;
3799
4025
  message: z.ZodString;
@@ -3833,6 +4059,12 @@ export declare const cliDataSchemas: {
3833
4059
  }>;
3834
4060
  }, z.core.$strict> | z.ZodObject<{
3835
4061
  owner: z.ZodString;
4062
+ }, z.core.$strict> | z.ZodObject<{
4063
+ by: z.ZodEnum<{
4064
+ operator: "operator";
4065
+ controller: "controller";
4066
+ host: "host";
4067
+ }>;
3836
4068
  }, z.core.$strict> | z.ZodObject<{
3837
4069
  owner: z.ZodString;
3838
4070
  }, z.core.$strict> | z.ZodObject<{
@@ -5690,6 +5922,36 @@ export declare const cliDataSchemas: {
5690
5922
  retries: z.ZodNullable<z.ZodNumber>;
5691
5923
  resets: z.ZodNullable<z.ZodNumber>;
5692
5924
  baseMoves: z.ZodNullable<z.ZodNumber>;
5925
+ recorded: z.ZodNullable<z.ZodObject<{
5926
+ from: z.ZodISODateTime;
5927
+ bound: z.ZodEnum<{
5928
+ exact: "exact";
5929
+ lower: "lower";
5930
+ }>;
5931
+ retries: z.ZodObject<{
5932
+ operator: z.ZodNumber;
5933
+ recovery: z.ZodNumber;
5934
+ host: z.ZodNumber;
5935
+ }, z.core.$strict>;
5936
+ resets: z.ZodObject<{
5937
+ operator: z.ZodNumber;
5938
+ recovery: z.ZodNumber;
5939
+ host: z.ZodNumber;
5940
+ }, z.core.$strict>;
5941
+ cancellations: z.ZodObject<{
5942
+ operator: z.ZodNumber;
5943
+ graph: z.ZodNumber;
5944
+ host: z.ZodNumber;
5945
+ }, z.core.$strict>;
5946
+ cancelledWithoutAttempt: z.ZodNumber;
5947
+ baseMoves: z.ZodObject<{
5948
+ operator: z.ZodNumber;
5949
+ controller: z.ZodNumber;
5950
+ host: z.ZodNumber;
5951
+ }, z.core.$strict>;
5952
+ baseMovesBound: z.ZodLiteral<"lower">;
5953
+ gaps: z.ZodNumber;
5954
+ }, z.core.$strict>>;
5693
5955
  }, z.core.$strict>;
5694
5956
  approvals: z.ZodObject<{
5695
5957
  operator: z.ZodNumber;
@@ -5928,7 +6190,34 @@ export declare const cliDataSchemas: {
5928
6190
  }, z.core.$strict>;
5929
6191
  setupCheckFailures: z.ZodNumber;
5930
6192
  timeLimit: z.ZodNumber;
5931
- causes: z.ZodNull;
6193
+ causes: z.ZodNullable<z.ZodObject<{
6194
+ rows: z.ZodArray<z.ZodObject<{
6195
+ cause: z.ZodEnum<{
6196
+ preflight: "preflight";
6197
+ transport: "transport";
6198
+ none: "none";
6199
+ other: "other";
6200
+ "provider-auth": "provider-auth";
6201
+ stalled: "stalled";
6202
+ shutdown: "shutdown";
6203
+ "sandbox-launch": "sandbox-launch";
6204
+ "sandbox-network": "sandbox-network";
6205
+ "sandbox-filesystem": "sandbox-filesystem";
6206
+ "sandbox-policy": "sandbox-policy";
6207
+ "dependency-network": "dependency-network";
6208
+ "provider-limit": "provider-limit";
6209
+ "lease-expired": "lease-expired";
6210
+ }>;
6211
+ count: z.ZodNumber;
6212
+ counted: z.ZodNumber;
6213
+ }, z.core.$strict>>;
6214
+ diagnosed: z.ZodNumber;
6215
+ undiagnosed: z.ZodNumber;
6216
+ bound: z.ZodEnum<{
6217
+ exact: "exact";
6218
+ lower: "lower";
6219
+ }>;
6220
+ }, z.core.$strict>>;
5932
6221
  neutral: z.ZodObject<{
5933
6222
  costBound: z.ZodEnum<{
5934
6223
  exact: "exact";
@@ -6673,6 +6962,7 @@ export declare const cliDataSchemas: {
6673
6962
  unfinished: z.ZodNumber;
6674
6963
  budgets: z.ZodNumber;
6675
6964
  budgetsWithin: z.ZodNumber;
6965
+ budgetsShared: z.ZodDefault<z.ZodNumber>;
6676
6966
  repairs: z.ZodNumber;
6677
6967
  intentions: z.ZodNumber;
6678
6968
  intentionsDropped: z.ZodNumber;