devcontour-harness 0.1.0-alpha.30 → 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 (97) hide show
  1. package/README.md +43 -16
  2. package/docs/architecture.md +12 -0
  3. package/docs/compatibility.md +21 -18
  4. package/docs/contracts.md +270 -12
  5. package/docs/release-notes/0.1.0-alpha.31.md +44 -0
  6. package/docs/release-notes/0.1.0-alpha.32.md +33 -0
  7. package/docs/release-notes/0.1.0-alpha.33.md +29 -0
  8. package/docs/release-notes/0.1.0-alpha.34.md +32 -0
  9. package/docs/upgrade.md +181 -0
  10. package/lib/agents/cli-adapter.js +1 -0
  11. package/lib/cli.js +25 -3
  12. package/lib/contracts/cli.d.ts +1381 -18
  13. package/lib/contracts/cli.js +43 -1
  14. package/lib/contracts/diagnosis.d.ts +2 -1
  15. package/lib/contracts/diagnosis.js +1 -0
  16. package/lib/contracts/events.d.ts +760 -5
  17. package/lib/contracts/events.js +109 -3
  18. package/lib/contracts/execution.d.ts +112 -1
  19. package/lib/contracts/execution.js +38 -0
  20. package/lib/contracts/failure.d.ts +6 -1
  21. package/lib/contracts/failure.js +5 -1
  22. package/lib/contracts/handoff.d.ts +702 -0
  23. package/lib/contracts/handoff.js +305 -0
  24. package/lib/contracts/index.d.ts +1 -0
  25. package/lib/contracts/index.js +1 -0
  26. package/lib/contracts/policy.d.ts +27 -1
  27. package/lib/contracts/policy.js +38 -2
  28. package/lib/contracts/published.d.ts +1016 -3
  29. package/lib/contracts/published.js +2 -0
  30. package/lib/contracts/repair-policy.js +5 -0
  31. package/lib/contracts/report.d.ts +118 -2
  32. package/lib/contracts/report.js +61 -3
  33. package/lib/control/base-move.d.ts +7 -2
  34. package/lib/control/base-move.js +14 -1
  35. package/lib/control/harness.d.ts +81 -19
  36. package/lib/control/harness.js +8 -93
  37. package/lib/control/recovery.d.ts +1 -1
  38. package/lib/control/status.d.ts +235 -0
  39. package/lib/control/status.js +101 -0
  40. package/lib/engine/budget.d.ts +78 -0
  41. package/lib/engine/budget.js +13 -2
  42. package/lib/engine/classify.d.ts +14 -1
  43. package/lib/engine/classify.js +34 -0
  44. package/lib/engine/engine.d.ts +31 -11
  45. package/lib/engine/engine.js +99 -5
  46. package/lib/engine/joint-runner.d.ts +6 -0
  47. package/lib/engine/joint-runner.js +20 -4
  48. package/lib/engine/property-recovery.js +1 -0
  49. package/lib/engine/reuse.js +1 -0
  50. package/lib/engine/runner.d.ts +8 -0
  51. package/lib/engine/runner.js +120 -16
  52. package/lib/engine/stall-sweep.d.ts +137 -0
  53. package/lib/engine/stall-sweep.js +393 -0
  54. package/lib/environment/activity.d.ts +34 -0
  55. package/lib/environment/activity.js +55 -0
  56. package/lib/environment/isolation.d.ts +67 -3
  57. package/lib/environment/isolation.js +148 -5
  58. package/lib/environment/lifecycle.js +2 -1
  59. package/lib/environment/process.d.ts +7 -1
  60. package/lib/environment/process.js +14 -0
  61. package/lib/environment/redaction.d.ts +2 -0
  62. package/lib/environment/redaction.js +19 -0
  63. package/lib/explain/state.d.ts +26 -5
  64. package/lib/explain/state.js +41 -0
  65. package/lib/handoff/index.d.ts +2 -0
  66. package/lib/handoff/index.js +3 -0
  67. package/lib/handoff/markdown.d.ts +6 -0
  68. package/lib/handoff/markdown.js +155 -0
  69. package/lib/handoff/pack.d.ts +79 -0
  70. package/lib/handoff/pack.js +531 -0
  71. package/lib/index.d.ts +19 -3
  72. package/lib/index.js +18 -1
  73. package/lib/integrations/connector/redact.d.ts +2 -13
  74. package/lib/integrations/connector/redact.js +2 -21
  75. package/lib/integrations/connector/testing.js +1 -1
  76. package/lib/projections/attempt.d.ts +28 -0
  77. package/lib/projections/attempt.js +14 -0
  78. package/lib/projections/next.d.ts +3 -1
  79. package/lib/projections/next.js +4 -1
  80. package/lib/projections/stop.d.ts +22 -1
  81. package/lib/projections/stop.js +73 -15
  82. package/lib/report/compute.js +229 -21
  83. package/lib/report/document.js +31 -7
  84. package/lib/storage/document.d.ts +28 -6
  85. package/lib/storage/sqlite.d.ts +2 -0
  86. package/lib/storage/sqlite.js +9 -1
  87. package/lib/verification/gates-at.d.ts +11 -1
  88. package/lib/verification/gates-at.js +28 -2
  89. package/lib/verification/gates.d.ts +3 -1
  90. package/lib/verification/gates.js +25 -4
  91. package/package.json +1 -1
  92. package/schemas/execution-document.schema.json +68 -0
  93. package/schemas/execution-policy.schema.json +32 -0
  94. package/schemas/handoff-pack.schema.json +1430 -0
  95. package/schemas/run-event.schema.json +679 -0
  96. package/schemas/stop-diagnosis.schema.json +1 -0
  97. package/schemas/value-report.schema.json +236 -3
@@ -0,0 +1,305 @@
1
+ import { z } from 'zod';
2
+ import { diagnosisActions, diagnosisActors, diagnosisCauses, diagnosisPhases, } from "./diagnosis.js";
3
+ import { errorCodes } from "./errors.js";
4
+ import { failureKindSchema, pauseReasons, workStatusSchema } from "./execution.js";
5
+ import { idSchema, isoTimeSchema } from "./primitives.js";
6
+ /**
7
+ * Пакет передачи контекста (`harness handoff`, `handoffPack`): состояние доски
8
+ * для следующей сессии ведущего агента, собранное из хранилища, а не из
9
+ * памяти агента. Факты — только из сохранённого состояния; свободный текст
10
+ * агента — только `intentions`.
11
+ *
12
+ * Пакет ограничен по размеру, чтобы поместиться в контекст агента: списки
13
+ * обрезаются по `HANDOFF_LIMITS` (число отброшенного — в `truncated`), каждая
14
+ * строка из хранилища очищается от escape-последовательностей и управляющих
15
+ * символов и усекается до предела своего поля с «…» (без разрыва суррогатной
16
+ * пары), а сериализованный пакет не больше `HANDOFF_MAX_BYTES` байт UTF-8:
17
+ * сверх него записи отбрасываются (`truncated.bySize`).
18
+ *
19
+ * Литералы `nextSteps` повторяют `src/projections/next.ts` (модуль без zod);
20
+ * тест сверяет оба перечня поэлементно.
21
+ */
22
+ export const HANDOFF_VERSION = 1;
23
+ export const HANDOFF_LIMITS = {
24
+ /** Открытые поручения (не принятые и не отменённые). */
25
+ works: 50,
26
+ /** Остановки и решения (`explain`), после свёртки одинаковых. */
27
+ stops: 30,
28
+ /** Ссылки evidence одной остановки. */
29
+ evidence: 5,
30
+ /** Поручения, перечисленные у свёрнутой остановки. */
31
+ stopWorks: 20,
32
+ /** Последние провалы попыток, новые первыми. */
33
+ failures: 10,
34
+ /** Незавершённые записи попыток. */
35
+ unfinished: 20,
36
+ /** Блокировки одного поручения. */
37
+ blockers: 3,
38
+ /** Строки бюджетов (общий и групп — первыми). */
39
+ budgets: 20,
40
+ /** Задания графов с восстановлениями. */
41
+ repairs: 10,
42
+ /** Намерения агента и знаков в каждом. */
43
+ intentions: 20,
44
+ intentionChars: 1000,
45
+ /** Предел строки факта из хранилища. */
46
+ text: 300,
47
+ /** Предел идентификатора, имени стадии, владельца из хранилища. */
48
+ name: 200,
49
+ };
50
+ /** Предел сериализованного пакета (JSON, UTF-8). */
51
+ export const HANDOFF_MAX_BYTES = 256 * 1024;
52
+ /**
53
+ * Наименьший предел, который хост может задать пакету (`maxBytes` у
54
+ * `handoffPack`): ниже него не помещается даже обычный минимальный пакет.
55
+ * Это не гарантия: записи, которые не отбрасываются (сводка, очередь, идущие
56
+ * попытки, задания, следующий шаг), могут не уложиться и в больший предел.
57
+ */
58
+ export const HANDOFF_MIN_BYTES = 4 * 1024;
59
+ /** Строка, усечённая до `n` знаков с «…». */
60
+ const clipped = (n) => z.string().max(n + 1);
61
+ const text = clipped(HANDOFF_LIMITS.text);
62
+ const name = clipped(HANDOFF_LIMITS.name);
63
+ const errorCodeSchema = z.enum(Object.keys(errorCodes));
64
+ const count = z.number().int().min(0);
65
+ export const handoffNextSteps = [
66
+ 'accepted',
67
+ 'cancelled',
68
+ 'recovery-awaiting-lead',
69
+ 'recovery-analyzing',
70
+ 'recovery-applying',
71
+ 'recovery-retry-allowed',
72
+ 'recovery-retrying',
73
+ 'recovery-awaiting-user',
74
+ 'recovery-stopped',
75
+ 'corpus-adoption',
76
+ 'held',
77
+ 'plan-review',
78
+ 'attempt-running',
79
+ 'retry-within-budget',
80
+ 'attempts-exhausted',
81
+ 'awaiting-claim',
82
+ ];
83
+ /** Команда harness, которая выполняет следующий шаг, когда он — запуск команды. */
84
+ export const handoffCommands = ['harness run', 'harness resume'];
85
+ /** Следующий шаг: кто действует и что (`nextAction`, `explain`). */
86
+ const nextSchema = z.strictObject({
87
+ actor: z.enum(diagnosisActors).nullable(),
88
+ action: z.enum(diagnosisActions),
89
+ step: z.enum(handoffNextSteps).optional(),
90
+ property: name.optional(),
91
+ detail: text.optional(),
92
+ command: z.enum(handoffCommands).optional(),
93
+ });
94
+ /**
95
+ * Остановка (`StopDiagnosis` explain) в пределах пакета. Одинаковые
96
+ * остановки на выдаче (общая пауза очереди и другие повторы одного диагноза)
97
+ * свёрнуты в одну запись без `workId`: `works` — первые затронутые поручения,
98
+ * `worksCount` — сколько их всего.
99
+ */
100
+ const stopSchema = z.strictObject({
101
+ code: errorCodeSchema,
102
+ cause: z.enum(diagnosisCauses),
103
+ phase: z.enum(diagnosisPhases),
104
+ actor: z.enum(diagnosisActors).nullable(),
105
+ action: z.enum(diagnosisActions),
106
+ retryPlanned: z.boolean(),
107
+ message: text,
108
+ evidence: z
109
+ .array(z.strictObject({
110
+ kind: z.enum(['attempt', 'evidence', 'event', 'doctor']),
111
+ id: name,
112
+ sha: z.string().max(64).optional(),
113
+ }))
114
+ .max(HANDOFF_LIMITS.evidence),
115
+ workId: idSchema.optional(),
116
+ runId: name.optional(),
117
+ /** Остановка выдачи всей очереди (её же показывает `queue`). */
118
+ queue: z.literal(true).optional(),
119
+ works: z.array(idSchema).max(HANDOFF_LIMITS.stopWorks).optional(),
120
+ worksCount: count.optional(),
121
+ });
122
+ export const handoffPackSchema = z.strictObject({
123
+ handoffVersion: z.literal(HANDOFF_VERSION),
124
+ /** Момент снимка (часы движка); весь пакет — одно чтение хранилища. */
125
+ at: isoTimeSchema,
126
+ /** Только этот граф (`--graph`); нет — вся доска. */
127
+ graphId: idSchema.optional(),
128
+ /** Пределы политики: попытки поручения и восстановления группы. */
129
+ limits: z.strictObject({ maxAttempts: z.number().int().positive(), repairBudget: count }),
130
+ summary: z.strictObject({
131
+ works: count,
132
+ open: count,
133
+ done: count,
134
+ cancelled: count,
135
+ byStatus: z.array(z.strictObject({ status: workStatusSchema, count: count })),
136
+ }),
137
+ /** Выдача очереди: пауза, причина и кто её снимает (как `status --detail`). */
138
+ queue: z.strictObject({
139
+ paused: z.boolean(),
140
+ reason: z.enum(pauseReasons).optional(),
141
+ detail: text.optional(),
142
+ since: isoTimeSchema.optional(),
143
+ /** Операция, держащая паузу (reconfigure, base-check): её применяют или отменяют. */
144
+ operation: name.optional(),
145
+ /** Классы отказа, которые держат паузу runtime. */
146
+ failures: z.array(failureKindSchema).optional(),
147
+ liftedByRun: z.literal(true).optional(),
148
+ code: errorCodeSchema.optional(),
149
+ actor: z.enum(diagnosisActors).nullable().optional(),
150
+ action: z.enum(diagnosisActions).optional(),
151
+ }),
152
+ /** Роль controller: кто держит и до какого времени; `live` — срок не истёк. */
153
+ controller: z.strictObject({ owner: name, until: isoTimeSchema, live: z.boolean() }).optional(),
154
+ /** Идущие попытки: поручение, стадия, свежесть владения, gates (`attemptView`). */
155
+ active: z.array(z.strictObject({
156
+ workId: idSchema,
157
+ title: text,
158
+ runId: name,
159
+ attempt: z.number().int().positive(),
160
+ phase: workStatusSchema,
161
+ runtime: name,
162
+ elapsedMs: count,
163
+ stage: z.strictObject({ name: name, elapsedMs: count }).optional(),
164
+ sinceHeartbeatMs: count.optional(),
165
+ /** Срок владения попыткой. */
166
+ leaseUntil: isoTimeSchema,
167
+ stale: z.boolean(),
168
+ gates: z.strictObject({
169
+ phase: z.enum(['candidate', 'integration']),
170
+ required: count,
171
+ passed: count,
172
+ failed: count,
173
+ remaining: count,
174
+ }),
175
+ })),
176
+ /**
177
+ * Незавершённые записи попыток: владение истекло (`stale`) или поручение
178
+ * уже не ссылается на попытку (`current: false`); их закрывает истечение
179
+ * срока при следующем `harness run` или cleanup, а не новая сессия.
180
+ */
181
+ unfinished: z.array(z.strictObject({
182
+ runId: name,
183
+ workId: idSchema,
184
+ attempt: z.number().int().positive(),
185
+ phase: workStatusSchema,
186
+ startedAt: isoTimeSchema,
187
+ stale: z.boolean(),
188
+ current: z.boolean(),
189
+ interrupted: z.literal('shutdown').optional(),
190
+ })),
191
+ /** Открытые поручения: статус, причина провала, блокировки и следующий шаг. */
192
+ works: z.array(z.strictObject({
193
+ id: idSchema,
194
+ graphId: idSchema,
195
+ title: text,
196
+ status: workStatusSchema,
197
+ attempt: count,
198
+ failureKind: failureKindSchema.optional(),
199
+ failure: text.optional(),
200
+ hold: z.strictObject({ operation: name, reason: text }).optional(),
201
+ recovery: z
202
+ .strictObject({
203
+ status: z.string().max(40),
204
+ property: name,
205
+ reason: text.optional(),
206
+ proposal: text.optional(),
207
+ })
208
+ .optional(),
209
+ /** Без паузы очереди: она одна на всех и показана в `queue`. */
210
+ blockers: z.array(z.strictObject({ code: errorCodeSchema, message: text })),
211
+ blockersTruncated: count.optional(),
212
+ next: nextSchema,
213
+ })),
214
+ /**
215
+ * Остановки и открытые решения (`explain` без проб runtime): код, причина,
216
+ * фаза, кто действует и допустимый шаг; решения (`actor` lead или user,
217
+ * действие не `wait`) — первыми.
218
+ */
219
+ stops: z.array(stopSchema),
220
+ /** Последние провалы попыток, новые первыми: класс отказа, код и причина. */
221
+ failures: z.array(z.strictObject({
222
+ runId: name,
223
+ workId: idSchema,
224
+ /** Текущий статус поручения (провал мог уже смениться повтором или приёмкой). */
225
+ workStatus: workStatusSchema.optional(),
226
+ attempt: z.number().int().positive(),
227
+ status: z.enum(['failed', 'expired']),
228
+ phase: workStatusSchema,
229
+ finishedAt: isoTimeSchema.optional(),
230
+ failureKind: failureKindSchema.optional(),
231
+ code: errorCodeSchema,
232
+ error: text.optional(),
233
+ })),
234
+ /**
235
+ * Бюджеты по записям вызовов: расход против предела. `reportedUsd` —
236
+ * сообщённое runtime, `estimatedUsd` — оценка по тарифу; `complete: false`
237
+ * — расход известен не полностью (вызовы без стоимости, незавершённые,
238
+ * брошенные, попытки без учёта), сумма — нижняя граница, `remaining*` —
239
+ * `null`. Бюджеты поручений в пределах и без расхода не перечисляются, как
240
+ * и поручений, весь расход которых — вызовы о их группе (`truncated.budgetsShared`).
241
+ * Нет поля — бюджеты не заданы.
242
+ */
243
+ budgets: z
244
+ .strictObject({
245
+ onUnknown: z.enum(['stop', 'continue']),
246
+ entries: z.array(z.strictObject({
247
+ scope: z.enum(['work', 'group', 'total']),
248
+ id: name.optional(),
249
+ state: z.enum(['within', 'exceeded', 'undetermined']),
250
+ limitUsd: z.number().positive().optional(),
251
+ limitMs: z.number().int().positive().optional(),
252
+ reportedUsd: z.number().min(0),
253
+ estimatedUsd: z.number().min(0),
254
+ complete: z.boolean(),
255
+ unknownCalls: count,
256
+ unfinishedCalls: count,
257
+ abandonedCalls: count,
258
+ uncoveredRuns: count,
259
+ durationMs: z.number().min(0),
260
+ remainingUsd: z.number().min(0).nullable(),
261
+ remainingMs: z.number().min(0).nullable(),
262
+ reason: text.optional(),
263
+ })),
264
+ })
265
+ .optional(),
266
+ /** Восстановления заданий графов: потрачено против бюджета. */
267
+ repairs: z
268
+ .array(z.strictObject({
269
+ graphId: idSchema,
270
+ status: z.string().max(40),
271
+ used: count,
272
+ budget: count,
273
+ }))
274
+ .max(HANDOFF_LIMITS.repairs),
275
+ /** Следующий шаг доски: первое решение lead/user, иначе ход controller. */
276
+ next: nextSchema.extend({ workId: idSchema.optional(), code: errorCodeSchema.optional() }),
277
+ /** Намерения агента — единственный текст не из хранилища. */
278
+ intentions: z.array(clipped(HANDOFF_LIMITS.intentionChars).min(1)).max(HANDOFF_LIMITS.intentions),
279
+ /**
280
+ * Сколько записей каждого списка не вошло в пакет (по пределу числа или
281
+ * размера). `budgets` — строки бюджетов сверх предела, `budgetsWithin` —
282
+ * бюджеты поручений в пределах и без расхода (не показаны намеренно),
283
+ * `budgetsShared` — бюджеты поручений, весь расход которых — вызовы о их
284
+ * группе (ревью и проверка плана): этот расход один и уже есть в строках
285
+ * группы и total, а не повторяется у каждого поручения;
286
+ * `intentions` — сколько намерений усечено по `intentionChars`,
287
+ * `intentionsDropped` — отброшено ради предела размера; `bySize` — пакет
288
+ * урезан до предела размера (`HANDOFF_MAX_BYTES` или меньший `maxBytes`
289
+ * хоста).
290
+ */
291
+ truncated: z.strictObject({
292
+ works: count,
293
+ stops: count,
294
+ failures: count,
295
+ unfinished: count,
296
+ budgets: count,
297
+ budgetsWithin: count,
298
+ // Пакеты прежних версий поля не знают: при разборе — 0.
299
+ budgetsShared: count.default(0),
300
+ repairs: count,
301
+ intentions: count,
302
+ intentionsDropped: count,
303
+ bySize: z.boolean(),
304
+ }),
305
+ });
@@ -21,3 +21,4 @@ export * from './diagnosis.ts';
21
21
  export * from './planning.ts';
22
22
  export * from './catalog.ts';
23
23
  export * from './report.ts';
24
+ export * from './handoff.ts';
@@ -21,3 +21,4 @@ export * from "./diagnosis.js";
21
21
  export * from "./planning.js";
22
22
  export * from "./catalog.js";
23
23
  export * from "./report.js";
24
+ export * from "./handoff.js";
@@ -992,6 +992,15 @@ export declare const executionPolicySchema: z.ZodObject<{
992
992
  reserveMs: z.ZodDefault<z.ZodNumber>;
993
993
  }, z.core.$strict>>;
994
994
  reviewProtocolRetries: z.ZodOptional<z.ZodNumber>;
995
+ stallSweep: z.ZodOptional<z.ZodObject<{
996
+ intervalMs: z.ZodDefault<z.ZodNumber>;
997
+ quietMs: z.ZodDefault<z.ZodNumber>;
998
+ stalledMs: z.ZodDefault<z.ZodNumber>;
999
+ action: z.ZodDefault<z.ZodEnum<{
1000
+ report: "report";
1001
+ stop: "stop";
1002
+ }>>;
1003
+ }, z.core.$strict>>;
995
1004
  maxAttempts: z.ZodDefault<z.ZodNumber>;
996
1005
  repairBudget: z.ZodDefault<z.ZodNumber>;
997
1006
  reuseImplementation: z.ZodDefault<z.ZodBoolean>;
@@ -1036,13 +1045,30 @@ export declare const executionPolicySchema: z.ZodObject<{
1036
1045
  }, z.core.$strict>>>;
1037
1046
  }, z.core.$strict>;
1038
1047
  export type ExecutionPolicy = z.infer<typeof executionPolicySchema>;
1048
+ /** Обход зависших попыток по умолчанию: умеренные пороги, только сообщение. */
1049
+ export declare const DEFAULT_STALL_SWEEP: {
1050
+ readonly intervalMs: 30000;
1051
+ readonly quietMs: 180000;
1052
+ readonly stalledMs: 600000;
1053
+ readonly action: "report";
1054
+ };
1055
+ export type StallSweepPolicy = {
1056
+ intervalMs: number;
1057
+ quietMs: number;
1058
+ stalledMs: number;
1059
+ action: 'stop' | 'report';
1060
+ };
1061
+ /** Действующий обход политики: заданный или умолчание. */
1062
+ export declare const stallSweepOf: (policy: Pick<ExecutionPolicy, "stallSweep">) => StallSweepPolicy;
1039
1063
  export type ExecutionPolicyInput = z.input<typeof executionPolicySchema>;
1040
1064
  export declare const policyDigest: (policy: ExecutionPolicy) => string;
1041
1065
  /**
1042
1066
  * Digest исполнительной части политики — основание согласования графа и
1043
1067
  * fencing попыток. Пределы бюджетов и тарифы в него не входят: это учёт, а не
1044
1068
  * условия исполнения, и поднятый предел действует сразу, без нового
1045
- * согласования (как в DevContour). `policyDigest` — digest загруженной
1069
+ * согласования (как в DevContour). Обход зависших (`stallSweep`) — тоже
1070
+ * надзор, а не условие исполнения кода: его пороги меняются без новой
1071
+ * попытки и не трогают основания reuse. `policyDigest` — digest загруженной
1046
1072
  * политики целиком: им сверяются применение политики (`appliedPolicy`) и
1047
1073
  * запрос операции reconfigure.
1048
1074
  */
@@ -275,6 +275,31 @@ export const executionPolicySchema = z.strictObject({
275
275
  * digest и pins прежней политики не меняются. См. docs/review-protocol.md.
276
276
  */
277
277
  reviewProtocolRetries: z.number().int().min(0).max(2).optional(),
278
+ /**
279
+ * Обход зависших попыток controller: каждые `intervalMs` он оценивает
280
+ * движение исполняющегося (вывод, команды, стадии, процессор дерева):
281
+ * `quiet` — нет движения дольше `quietMs`, `stalled` — дольше `stalledMs`.
282
+ * На `stalled` — снимок процессов и хвоста вывода и действие `action`:
283
+ * `report` только сообщает, `stop` останавливает попытку исходом
284
+ * `stalled`. Нет поля — умолчания `DEFAULT_STALL_SWEEP`; они не
285
+ * подставляются в политику, и digest прежних политик не меняется.
286
+ */
287
+ stallSweep: z
288
+ .strictObject({
289
+ intervalMs: z.number().int().min(1000).max(600_000).default(30_000),
290
+ quietMs: z.number().int().positive().max(86_400_000).default(180_000),
291
+ stalledMs: z.number().int().positive().max(86_400_000).default(600_000),
292
+ action: z.enum(['stop', 'report']).default('report'),
293
+ })
294
+ .refine((s) => s.quietMs < s.stalledMs, {
295
+ message: 'stallSweep.quietMs должен быть меньше stalledMs',
296
+ path: ['quietMs'],
297
+ })
298
+ .refine((s) => s.intervalMs <= s.quietMs, {
299
+ message: 'stallSweep.intervalMs не больше quietMs: иначе quiet не заметить вовремя',
300
+ path: ['intervalMs'],
301
+ })
302
+ .optional(),
278
303
  maxAttempts: z.number().int().min(1).max(10).default(3),
279
304
  repairBudget: z.number().int().min(0).max(50).default(6),
280
305
  reuseImplementation: z.boolean().default(true),
@@ -291,16 +316,27 @@ export const executionPolicySchema = z.strictObject({
291
316
  .optional(),
292
317
  prices: z.array(priceSchema).max(100).default([]),
293
318
  });
319
+ /** Обход зависших попыток по умолчанию: умеренные пороги, только сообщение. */
320
+ export const DEFAULT_STALL_SWEEP = {
321
+ intervalMs: 30_000,
322
+ quietMs: 180_000,
323
+ stalledMs: 600_000,
324
+ action: 'report',
325
+ };
326
+ /** Действующий обход политики: заданный или умолчание. */
327
+ export const stallSweepOf = (policy) => policy.stallSweep ?? DEFAULT_STALL_SWEEP;
294
328
  export const policyDigest = (policy) => digestOf(policy);
295
329
  /**
296
330
  * Digest исполнительной части политики — основание согласования графа и
297
331
  * fencing попыток. Пределы бюджетов и тарифы в него не входят: это учёт, а не
298
332
  * условия исполнения, и поднятый предел действует сразу, без нового
299
- * согласования (как в DevContour). `policyDigest` — digest загруженной
333
+ * согласования (как в DevContour). Обход зависших (`stallSweep`) — тоже
334
+ * надзор, а не условие исполнения кода: его пороги меняются без новой
335
+ * попытки и не трогают основания reuse. `policyDigest` — digest загруженной
300
336
  * политики целиком: им сверяются применение политики (`appliedPolicy`) и
301
337
  * запрос операции reconfigure.
302
338
  */
303
- export const executionDigest = (policy) => digestOf({ ...policy, budgets: undefined, prices: undefined });
339
+ export const executionDigest = (policy) => digestOf({ ...policy, budgets: undefined, prices: undefined, stallSweep: undefined });
304
340
  /**
305
341
  * Привязка роли для поручения репозитория: роль, переопределённая
306
342
  * репозиторием, целиком заменяет роль политики. Единственная точка поиска