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.
- package/README.md +43 -16
- package/docs/architecture.md +12 -0
- package/docs/compatibility.md +21 -18
- package/docs/contracts.md +270 -12
- package/docs/release-notes/0.1.0-alpha.31.md +44 -0
- package/docs/release-notes/0.1.0-alpha.32.md +33 -0
- package/docs/release-notes/0.1.0-alpha.33.md +29 -0
- package/docs/release-notes/0.1.0-alpha.34.md +32 -0
- package/docs/upgrade.md +181 -0
- package/lib/agents/cli-adapter.js +1 -0
- package/lib/cli.js +25 -3
- package/lib/contracts/cli.d.ts +1381 -18
- package/lib/contracts/cli.js +43 -1
- package/lib/contracts/diagnosis.d.ts +2 -1
- package/lib/contracts/diagnosis.js +1 -0
- package/lib/contracts/events.d.ts +760 -5
- package/lib/contracts/events.js +109 -3
- package/lib/contracts/execution.d.ts +112 -1
- package/lib/contracts/execution.js +38 -0
- package/lib/contracts/failure.d.ts +6 -1
- package/lib/contracts/failure.js +5 -1
- package/lib/contracts/handoff.d.ts +702 -0
- package/lib/contracts/handoff.js +305 -0
- package/lib/contracts/index.d.ts +1 -0
- package/lib/contracts/index.js +1 -0
- package/lib/contracts/policy.d.ts +27 -1
- package/lib/contracts/policy.js +38 -2
- package/lib/contracts/published.d.ts +1016 -3
- package/lib/contracts/published.js +2 -0
- package/lib/contracts/repair-policy.js +5 -0
- package/lib/contracts/report.d.ts +118 -2
- package/lib/contracts/report.js +61 -3
- package/lib/control/base-move.d.ts +7 -2
- package/lib/control/base-move.js +14 -1
- package/lib/control/harness.d.ts +81 -19
- package/lib/control/harness.js +8 -93
- package/lib/control/recovery.d.ts +1 -1
- package/lib/control/status.d.ts +235 -0
- package/lib/control/status.js +101 -0
- package/lib/engine/budget.d.ts +78 -0
- package/lib/engine/budget.js +13 -2
- package/lib/engine/classify.d.ts +14 -1
- package/lib/engine/classify.js +34 -0
- package/lib/engine/engine.d.ts +31 -11
- package/lib/engine/engine.js +99 -5
- package/lib/engine/joint-runner.d.ts +6 -0
- package/lib/engine/joint-runner.js +20 -4
- package/lib/engine/property-recovery.js +1 -0
- package/lib/engine/reuse.js +1 -0
- package/lib/engine/runner.d.ts +8 -0
- package/lib/engine/runner.js +120 -16
- package/lib/engine/stall-sweep.d.ts +137 -0
- package/lib/engine/stall-sweep.js +393 -0
- package/lib/environment/activity.d.ts +34 -0
- package/lib/environment/activity.js +55 -0
- package/lib/environment/isolation.d.ts +67 -3
- package/lib/environment/isolation.js +148 -5
- package/lib/environment/lifecycle.js +2 -1
- package/lib/environment/process.d.ts +7 -1
- package/lib/environment/process.js +14 -0
- package/lib/environment/redaction.d.ts +2 -0
- package/lib/environment/redaction.js +19 -0
- package/lib/explain/state.d.ts +26 -5
- package/lib/explain/state.js +41 -0
- package/lib/handoff/index.d.ts +2 -0
- package/lib/handoff/index.js +3 -0
- package/lib/handoff/markdown.d.ts +6 -0
- package/lib/handoff/markdown.js +155 -0
- package/lib/handoff/pack.d.ts +79 -0
- package/lib/handoff/pack.js +531 -0
- package/lib/index.d.ts +19 -3
- package/lib/index.js +18 -1
- package/lib/integrations/connector/redact.d.ts +2 -13
- package/lib/integrations/connector/redact.js +2 -21
- package/lib/integrations/connector/testing.js +1 -1
- package/lib/projections/attempt.d.ts +28 -0
- package/lib/projections/attempt.js +14 -0
- package/lib/projections/next.d.ts +3 -1
- package/lib/projections/next.js +4 -1
- package/lib/projections/stop.d.ts +22 -1
- package/lib/projections/stop.js +73 -15
- package/lib/report/compute.js +229 -21
- package/lib/report/document.js +31 -7
- package/lib/storage/document.d.ts +28 -6
- package/lib/storage/sqlite.d.ts +2 -0
- package/lib/storage/sqlite.js +9 -1
- package/lib/verification/gates-at.d.ts +11 -1
- package/lib/verification/gates-at.js +28 -2
- package/lib/verification/gates.d.ts +3 -1
- package/lib/verification/gates.js +25 -4
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +68 -0
- package/schemas/execution-policy.schema.json +32 -0
- package/schemas/handoff-pack.schema.json +1430 -0
- package/schemas/run-event.schema.json +679 -0
- package/schemas/stop-diagnosis.schema.json +1 -0
- package/schemas/value-report.schema.json +236 -3
package/lib/contracts/events.js
CHANGED
|
@@ -2,11 +2,40 @@ import { z } from 'zod';
|
|
|
2
2
|
import { API_VERSION } from "./version.js";
|
|
3
3
|
import { digestSchema, gitShaSchema, idSchema, isoTimeSchema, runtimeNameSchema, } from "./primitives.js";
|
|
4
4
|
import { sourceRefSchema } from "./work.js";
|
|
5
|
-
import { failureKindSchema, workStatusSchema } from "./execution.js";
|
|
5
|
+
import { activitySchema, failureKindSchema, livenessStateSchema, stallActionSchema, workStatusSchema, } from "./execution.js";
|
|
6
6
|
const sha = gitShaSchema;
|
|
7
7
|
const text = z.string().max(4000);
|
|
8
8
|
const runtime = runtimeNameSchema;
|
|
9
9
|
const phase = z.enum(['candidate', 'integration']);
|
|
10
|
+
/**
|
|
11
|
+
* Причина отказа окружения (`attempt.diagnosed`): ставится в точке
|
|
12
|
+
* обнаружения (песочница gate, сеть установки зависимостей, провайдер,
|
|
13
|
+
* транспорт), а не разбором текста потом. `none` — отказ не окружения
|
|
14
|
+
* (код, ревью, область); `other` — отказ окружения без известной причины.
|
|
15
|
+
*/
|
|
16
|
+
export const environmentCauses = [
|
|
17
|
+
'sandbox-launch',
|
|
18
|
+
'sandbox-network',
|
|
19
|
+
'sandbox-filesystem',
|
|
20
|
+
'sandbox-policy',
|
|
21
|
+
'dependency-network',
|
|
22
|
+
'provider-auth',
|
|
23
|
+
'provider-limit',
|
|
24
|
+
'transport',
|
|
25
|
+
'preflight',
|
|
26
|
+
'lease-expired',
|
|
27
|
+
'stalled',
|
|
28
|
+
'shutdown',
|
|
29
|
+
'other',
|
|
30
|
+
'none',
|
|
31
|
+
];
|
|
32
|
+
export const environmentCauseSchema = z.enum(environmentCauses);
|
|
33
|
+
/** Кто повторил поручение (`work.retried`): `host` — хост не назвал актёра. */
|
|
34
|
+
export const retryActors = ['operator', 'recovery', 'host'];
|
|
35
|
+
/** Кто отменил поручение (`work.cancelled`): `graph` — новая редакция графа его убрала. */
|
|
36
|
+
export const cancelActors = ['operator', 'host', 'graph'];
|
|
37
|
+
/** Кто сдвинул ref базы (`base.moved`): `host` — хост не назвал актёра. */
|
|
38
|
+
export const baseMoveActors = ['operator', 'controller', 'host'];
|
|
10
39
|
/** Предел имени стадии в событии `attempt.stage`. */
|
|
11
40
|
export const STAGE_NAME_LIMIT = 300;
|
|
12
41
|
const delivery = {
|
|
@@ -15,6 +44,34 @@ const delivery = {
|
|
|
15
44
|
revision: z.string().min(1).max(200),
|
|
16
45
|
attempts: z.number().int().min(0),
|
|
17
46
|
};
|
|
47
|
+
/** Переход живости по обходу зависших: общая часть событий попытки и совместной проверки. */
|
|
48
|
+
const liveness = {
|
|
49
|
+
state: livenessStateSchema,
|
|
50
|
+
previous: livenessStateSchema,
|
|
51
|
+
lastMovementAt: isoTimeSchema,
|
|
52
|
+
idleMs: z.number().int().min(0),
|
|
53
|
+
activity: activitySchema.optional(),
|
|
54
|
+
/** ps не дал данных о процессах: оценка только по выводу, не выше `quiet`. */
|
|
55
|
+
cpuUnavailable: z.boolean().optional(),
|
|
56
|
+
action: stallActionSchema.optional(),
|
|
57
|
+
snapshot: z
|
|
58
|
+
.strictObject({
|
|
59
|
+
processes: z
|
|
60
|
+
.array(z.strictObject({
|
|
61
|
+
pid: z.number().int().positive(),
|
|
62
|
+
parentPid: z.number().int().min(0),
|
|
63
|
+
/** Процессорное время; нет — ps его не сообщил. */
|
|
64
|
+
cpuMs: z.number().int().min(0).optional(),
|
|
65
|
+
command: z.string().max(300),
|
|
66
|
+
}))
|
|
67
|
+
.max(20),
|
|
68
|
+
/** ps не дал списка процессов: снимок только из вывода. */
|
|
69
|
+
processesUnavailable: z.boolean().optional(),
|
|
70
|
+
tail: z.string().max(2000),
|
|
71
|
+
artifact: z.string().max(1000).optional(),
|
|
72
|
+
})
|
|
73
|
+
.optional(),
|
|
74
|
+
};
|
|
18
75
|
/**
|
|
19
76
|
* Нагрузка каждого типа события — закрытая схема: лишних полей нет, и
|
|
20
77
|
* поэтому в событие нельзя положить fencing-токен, секрет или произвольный
|
|
@@ -90,11 +147,27 @@ export const eventPayloads = {
|
|
|
90
147
|
/** Только у `finished`. */
|
|
91
148
|
outcome: z.enum(['passed', 'failed']).optional(),
|
|
92
149
|
}),
|
|
150
|
+
/**
|
|
151
|
+
* Обход controller сменил живость исполняющейся попытки (только переходы).
|
|
152
|
+
* У `stalled` — снимок: процессы исполняющихся команд и хвост их вывода
|
|
153
|
+
* (замаскированные), и что controller сделал (`action`).
|
|
154
|
+
*/
|
|
155
|
+
'attempt.liveness': z.strictObject(liveness),
|
|
93
156
|
'attempt.failed': z.strictObject({
|
|
94
157
|
failureKind: failureKindSchema,
|
|
95
158
|
message: text,
|
|
96
159
|
blocked: z.boolean(),
|
|
97
160
|
}),
|
|
161
|
+
/**
|
|
162
|
+
* Причина отказа попытки: пишется в той же транзакции, что `attempt.failed`
|
|
163
|
+
* (и `attempt.expired`, причина `lease-expired`). `counted` — отказ
|
|
164
|
+
* засчитан в предел попыток поручения. Текста отказа здесь нет.
|
|
165
|
+
*/
|
|
166
|
+
'attempt.diagnosed': z.strictObject({
|
|
167
|
+
failureKind: failureKindSchema,
|
|
168
|
+
cause: environmentCauseSchema,
|
|
169
|
+
counted: z.boolean(),
|
|
170
|
+
}),
|
|
98
171
|
'attempt.expired': z.strictObject({ leaseUntil: z.number().int().min(0) }),
|
|
99
172
|
'attempt.cancelled': z.strictObject({ reason: text }),
|
|
100
173
|
'attempt.recovered': z.strictObject({
|
|
@@ -103,6 +176,23 @@ export const eventPayloads = {
|
|
|
103
176
|
reason: text.optional(),
|
|
104
177
|
}),
|
|
105
178
|
'work.accepted': z.strictObject({ resultSha: sha, integrationSha: sha }),
|
|
179
|
+
/**
|
|
180
|
+
* Поручение возвращено в очередь повтором (`engine.retry`). `reset` —
|
|
181
|
+
* сброс исчерпанного предела; `spent` — засчитанных попыток до сброса
|
|
182
|
+
* (сброс обнуляет счётчик). Причины сброса нет: только её длина.
|
|
183
|
+
*/
|
|
184
|
+
'work.retried': z.strictObject({
|
|
185
|
+
by: z.enum(retryActors),
|
|
186
|
+
reset: z.boolean(),
|
|
187
|
+
spent: z.number().int().min(0).optional(),
|
|
188
|
+
reasonLength: z.number().int().min(0).optional(),
|
|
189
|
+
}),
|
|
190
|
+
/**
|
|
191
|
+
* Поручение отменено (`engine.cancel` или новая редакция графа).
|
|
192
|
+
* `hadAttempt` — отменена и активная попытка (её `attempt.cancelled` — в
|
|
193
|
+
* той же транзакции).
|
|
194
|
+
*/
|
|
195
|
+
'work.cancelled': z.strictObject({ by: z.enum(cancelActors), hadAttempt: z.boolean() }),
|
|
106
196
|
'work.blocked': z.strictObject({ code: z.string().min(1).max(60), message: text }),
|
|
107
197
|
'control.paused': z.strictObject({
|
|
108
198
|
reason: z.enum(['operator', 'shutdown', 'runtime', 'base-check', 'reconfigure']),
|
|
@@ -112,6 +202,11 @@ export const eventPayloads = {
|
|
|
112
202
|
reason: z.enum(['operator', 'shutdown', 'runtime', 'base-check', 'reconfigure']),
|
|
113
203
|
}),
|
|
114
204
|
'controller.acquired': z.strictObject({ owner: z.string().min(1).max(300) }),
|
|
205
|
+
/**
|
|
206
|
+
* Ref базы сдвинут (`fencedRefMove`) — в той же транзакции, что проверка
|
|
207
|
+
* владения и `git update-ref`. Одно событие на репозиторий.
|
|
208
|
+
*/
|
|
209
|
+
'base.moved': z.strictObject({ by: z.enum(baseMoveActors) }),
|
|
115
210
|
'controller.released': z.strictObject({ owner: z.string().min(1).max(300) }),
|
|
116
211
|
'budget.blocked': z.strictObject({
|
|
117
212
|
scope: z.enum(['work', 'group', 'total']),
|
|
@@ -150,6 +245,15 @@ export const eventPayloads = {
|
|
|
150
245
|
workIds: z.array(idSchema).max(500),
|
|
151
246
|
policyDigest: digestSchema,
|
|
152
247
|
}),
|
|
248
|
+
/**
|
|
249
|
+
* Обход зависших совместной проверки сменил её живость (только переходы);
|
|
250
|
+
* нагрузка — как у `attempt.liveness`. При `report` это единственный след
|
|
251
|
+
* зависания: записи попытки у проверки нет.
|
|
252
|
+
*/
|
|
253
|
+
'joint.liveness': z.strictObject({
|
|
254
|
+
verificationId: z.string().min(1).max(200),
|
|
255
|
+
...liveness,
|
|
256
|
+
}),
|
|
153
257
|
/** Совместная проверка закончилась: `passed` — только с manifest. */
|
|
154
258
|
'joint.finished': z.strictObject({
|
|
155
259
|
verificationId: z.string().min(1).max(200),
|
|
@@ -250,6 +354,7 @@ export const transactionKinds = [
|
|
|
250
354
|
'run.model',
|
|
251
355
|
'run.timing.started',
|
|
252
356
|
'run.timing.finished',
|
|
357
|
+
'run.liveness',
|
|
253
358
|
'evidence.recorded',
|
|
254
359
|
'reproduction.recorded',
|
|
255
360
|
'findings.recorded',
|
|
@@ -287,9 +392,10 @@ export const transactionKinds = [
|
|
|
287
392
|
'workspace.evidence',
|
|
288
393
|
'workspace.verified',
|
|
289
394
|
'workspace.failed',
|
|
395
|
+
'workspace.liveness',
|
|
290
396
|
/**
|
|
291
|
-
* Сдвиг ref базы
|
|
292
|
-
*
|
|
397
|
+
* Сдвиг ref базы внутри транзакции проверки владения: проверка, синхронный
|
|
398
|
+
* `git update-ref` и событие `base.moved`; записей нет.
|
|
293
399
|
*/
|
|
294
400
|
'base.moved',
|
|
295
401
|
/** Только локальные записи технической очереди (`workflow-jobs`); событий журнала нет. */
|
|
@@ -24,7 +24,7 @@ export declare const workStatusSchema: z.ZodEnum<{
|
|
|
24
24
|
done: "done";
|
|
25
25
|
}>;
|
|
26
26
|
export type WorkStatus = (typeof workStatuses)[number];
|
|
27
|
-
export declare const failureKinds: readonly ["provider-auth", "environment", "timeout", "stale-base", "empty-result", "unfinished", "scope-violation", "gate", "review", "review-protocol", "merge", "cancelled", "budget", "needs-lead", "unknown"];
|
|
27
|
+
export declare const failureKinds: readonly ["provider-auth", "environment", "timeout", "stalled", "stale-base", "empty-result", "unfinished", "scope-violation", "gate", "review", "review-protocol", "merge", "cancelled", "budget", "needs-lead", "unknown"];
|
|
28
28
|
export declare const failureKindSchema: z.ZodEnum<{
|
|
29
29
|
gate: "gate";
|
|
30
30
|
unknown: "unknown";
|
|
@@ -33,6 +33,7 @@ export declare const failureKindSchema: z.ZodEnum<{
|
|
|
33
33
|
environment: "environment";
|
|
34
34
|
timeout: "timeout";
|
|
35
35
|
"provider-auth": "provider-auth";
|
|
36
|
+
stalled: "stalled";
|
|
36
37
|
"stale-base": "stale-base";
|
|
37
38
|
"empty-result": "empty-result";
|
|
38
39
|
unfinished: "unfinished";
|
|
@@ -43,6 +44,61 @@ export declare const failureKindSchema: z.ZodEnum<{
|
|
|
43
44
|
"needs-lead": "needs-lead";
|
|
44
45
|
}>;
|
|
45
46
|
export type FailureKind = (typeof failureKinds)[number];
|
|
47
|
+
/**
|
|
48
|
+
* Живость исполняющейся попытки по периодическому обходу controller
|
|
49
|
+
* (`stallSweep` политики): `active` — движение было недавно, `quiet` — нет
|
|
50
|
+
* движения дольше `quietMs`, `stalled` — дольше `stalledMs`. Движение —
|
|
51
|
+
* вывод процесса, начало или конец его команды, граница стадии
|
|
52
|
+
* (`attempt.stage`), заметный расход процессора деревом процессов.
|
|
53
|
+
*/
|
|
54
|
+
export declare const livenessStates: readonly ["active", "quiet", "stalled"];
|
|
55
|
+
export declare const livenessStateSchema: z.ZodEnum<{
|
|
56
|
+
active: "active";
|
|
57
|
+
stalled: "stalled";
|
|
58
|
+
quiet: "quiet";
|
|
59
|
+
}>;
|
|
60
|
+
export type LivenessState = (typeof livenessStates)[number];
|
|
61
|
+
/** Что исполняется: вызов агента, gate, шаг среды или прочая команда попытки. */
|
|
62
|
+
export declare const activitySchema: z.ZodObject<{
|
|
63
|
+
kind: z.ZodEnum<{
|
|
64
|
+
gate: "gate";
|
|
65
|
+
command: "command";
|
|
66
|
+
agent: "agent";
|
|
67
|
+
step: "step";
|
|
68
|
+
}>;
|
|
69
|
+
label: z.ZodString;
|
|
70
|
+
}, z.core.$strict>;
|
|
71
|
+
export type Activity = z.infer<typeof activitySchema>;
|
|
72
|
+
/** Действие controller на `stalled`: остановить процесс или только сообщить. */
|
|
73
|
+
export declare const stallActionSchema: z.ZodEnum<{
|
|
74
|
+
report: "report";
|
|
75
|
+
stop: "stop";
|
|
76
|
+
}>;
|
|
77
|
+
/** Последнее состояние живости попытки; пишется только на переходах. */
|
|
78
|
+
export declare const attemptLivenessSchema: z.ZodObject<{
|
|
79
|
+
state: z.ZodEnum<{
|
|
80
|
+
active: "active";
|
|
81
|
+
stalled: "stalled";
|
|
82
|
+
quiet: "quiet";
|
|
83
|
+
}>;
|
|
84
|
+
at: z.ZodISODateTime;
|
|
85
|
+
lastMovementAt: z.ZodISODateTime;
|
|
86
|
+
activity: z.ZodOptional<z.ZodObject<{
|
|
87
|
+
kind: z.ZodEnum<{
|
|
88
|
+
gate: "gate";
|
|
89
|
+
command: "command";
|
|
90
|
+
agent: "agent";
|
|
91
|
+
step: "step";
|
|
92
|
+
}>;
|
|
93
|
+
label: z.ZodString;
|
|
94
|
+
}, z.core.$strict>>;
|
|
95
|
+
action: z.ZodOptional<z.ZodEnum<{
|
|
96
|
+
report: "report";
|
|
97
|
+
stop: "stop";
|
|
98
|
+
}>>;
|
|
99
|
+
artifact: z.ZodOptional<z.ZodString>;
|
|
100
|
+
}, z.core.$strict>;
|
|
101
|
+
export type AttemptLiveness = z.infer<typeof attemptLivenessSchema>;
|
|
46
102
|
/** Техническое согласование, привязанное к digest проверенного предложения. */
|
|
47
103
|
export declare const technicalApprovalSchema: z.ZodObject<{
|
|
48
104
|
actor: z.ZodEnum<{
|
|
@@ -601,6 +657,7 @@ export declare const continuationSchema: z.ZodObject<{
|
|
|
601
657
|
environment: "environment";
|
|
602
658
|
timeout: "timeout";
|
|
603
659
|
"provider-auth": "provider-auth";
|
|
660
|
+
stalled: "stalled";
|
|
604
661
|
"stale-base": "stale-base";
|
|
605
662
|
"empty-result": "empty-result";
|
|
606
663
|
unfinished: "unfinished";
|
|
@@ -686,6 +743,7 @@ export declare const attemptStateSchema: z.ZodObject<{
|
|
|
686
743
|
environment: "environment";
|
|
687
744
|
timeout: "timeout";
|
|
688
745
|
"provider-auth": "provider-auth";
|
|
746
|
+
stalled: "stalled";
|
|
689
747
|
"stale-base": "stale-base";
|
|
690
748
|
"empty-result": "empty-result";
|
|
691
749
|
unfinished: "unfinished";
|
|
@@ -798,6 +856,7 @@ export declare const attemptStateSchema: z.ZodObject<{
|
|
|
798
856
|
environment: "environment";
|
|
799
857
|
timeout: "timeout";
|
|
800
858
|
"provider-auth": "provider-auth";
|
|
859
|
+
stalled: "stalled";
|
|
801
860
|
"stale-base": "stale-base";
|
|
802
861
|
"empty-result": "empty-result";
|
|
803
862
|
unfinished: "unfinished";
|
|
@@ -828,6 +887,29 @@ export declare const attemptStateSchema: z.ZodObject<{
|
|
|
828
887
|
approvedAt: z.ZodOptional<z.ZodISODateTime>;
|
|
829
888
|
readyAt: z.ZodOptional<z.ZodISODateTime>;
|
|
830
889
|
}, z.core.$strict>>;
|
|
890
|
+
liveness: z.ZodOptional<z.ZodObject<{
|
|
891
|
+
state: z.ZodEnum<{
|
|
892
|
+
active: "active";
|
|
893
|
+
stalled: "stalled";
|
|
894
|
+
quiet: "quiet";
|
|
895
|
+
}>;
|
|
896
|
+
at: z.ZodISODateTime;
|
|
897
|
+
lastMovementAt: z.ZodISODateTime;
|
|
898
|
+
activity: z.ZodOptional<z.ZodObject<{
|
|
899
|
+
kind: z.ZodEnum<{
|
|
900
|
+
gate: "gate";
|
|
901
|
+
command: "command";
|
|
902
|
+
agent: "agent";
|
|
903
|
+
step: "step";
|
|
904
|
+
}>;
|
|
905
|
+
label: z.ZodString;
|
|
906
|
+
}, z.core.$strict>>;
|
|
907
|
+
action: z.ZodOptional<z.ZodEnum<{
|
|
908
|
+
report: "report";
|
|
909
|
+
stop: "stop";
|
|
910
|
+
}>>;
|
|
911
|
+
artifact: z.ZodOptional<z.ZodString>;
|
|
912
|
+
}, z.core.$strict>>;
|
|
831
913
|
timings: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
832
914
|
id: z.ZodString;
|
|
833
915
|
stage: z.ZodString;
|
|
@@ -1264,6 +1346,7 @@ export declare const workStateSchema: z.ZodObject<{
|
|
|
1264
1346
|
environment: "environment";
|
|
1265
1347
|
timeout: "timeout";
|
|
1266
1348
|
"provider-auth": "provider-auth";
|
|
1349
|
+
stalled: "stalled";
|
|
1267
1350
|
"stale-base": "stale-base";
|
|
1268
1351
|
"empty-result": "empty-result";
|
|
1269
1352
|
unfinished: "unfinished";
|
|
@@ -1540,6 +1623,7 @@ export declare const controlStateSchema: z.ZodObject<{
|
|
|
1540
1623
|
environment: "environment";
|
|
1541
1624
|
timeout: "timeout";
|
|
1542
1625
|
"provider-auth": "provider-auth";
|
|
1626
|
+
stalled: "stalled";
|
|
1543
1627
|
"stale-base": "stale-base";
|
|
1544
1628
|
"empty-result": "empty-result";
|
|
1545
1629
|
unfinished: "unfinished";
|
|
@@ -2883,6 +2967,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
|
|
|
2883
2967
|
environment: "environment";
|
|
2884
2968
|
timeout: "timeout";
|
|
2885
2969
|
"provider-auth": "provider-auth";
|
|
2970
|
+
stalled: "stalled";
|
|
2886
2971
|
"stale-base": "stale-base";
|
|
2887
2972
|
"empty-result": "empty-result";
|
|
2888
2973
|
unfinished: "unfinished";
|
|
@@ -3099,6 +3184,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
|
|
|
3099
3184
|
environment: "environment";
|
|
3100
3185
|
timeout: "timeout";
|
|
3101
3186
|
"provider-auth": "provider-auth";
|
|
3187
|
+
stalled: "stalled";
|
|
3102
3188
|
"stale-base": "stale-base";
|
|
3103
3189
|
"empty-result": "empty-result";
|
|
3104
3190
|
unfinished: "unfinished";
|
|
@@ -3211,6 +3297,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
|
|
|
3211
3297
|
environment: "environment";
|
|
3212
3298
|
timeout: "timeout";
|
|
3213
3299
|
"provider-auth": "provider-auth";
|
|
3300
|
+
stalled: "stalled";
|
|
3214
3301
|
"stale-base": "stale-base";
|
|
3215
3302
|
"empty-result": "empty-result";
|
|
3216
3303
|
unfinished: "unfinished";
|
|
@@ -3241,6 +3328,29 @@ export declare const executionDocumentSchema: z.ZodObject<{
|
|
|
3241
3328
|
approvedAt: z.ZodOptional<z.ZodISODateTime>;
|
|
3242
3329
|
readyAt: z.ZodOptional<z.ZodISODateTime>;
|
|
3243
3330
|
}, z.core.$strict>>;
|
|
3331
|
+
liveness: z.ZodOptional<z.ZodObject<{
|
|
3332
|
+
state: z.ZodEnum<{
|
|
3333
|
+
active: "active";
|
|
3334
|
+
stalled: "stalled";
|
|
3335
|
+
quiet: "quiet";
|
|
3336
|
+
}>;
|
|
3337
|
+
at: z.ZodISODateTime;
|
|
3338
|
+
lastMovementAt: z.ZodISODateTime;
|
|
3339
|
+
activity: z.ZodOptional<z.ZodObject<{
|
|
3340
|
+
kind: z.ZodEnum<{
|
|
3341
|
+
gate: "gate";
|
|
3342
|
+
command: "command";
|
|
3343
|
+
agent: "agent";
|
|
3344
|
+
step: "step";
|
|
3345
|
+
}>;
|
|
3346
|
+
label: z.ZodString;
|
|
3347
|
+
}, z.core.$strict>>;
|
|
3348
|
+
action: z.ZodOptional<z.ZodEnum<{
|
|
3349
|
+
report: "report";
|
|
3350
|
+
stop: "stop";
|
|
3351
|
+
}>>;
|
|
3352
|
+
artifact: z.ZodOptional<z.ZodString>;
|
|
3353
|
+
}, z.core.$strict>>;
|
|
3244
3354
|
timings: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
3245
3355
|
id: z.ZodString;
|
|
3246
3356
|
stage: z.ZodString;
|
|
@@ -3755,6 +3865,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
|
|
|
3755
3865
|
environment: "environment";
|
|
3756
3866
|
timeout: "timeout";
|
|
3757
3867
|
"provider-auth": "provider-auth";
|
|
3868
|
+
stalled: "stalled";
|
|
3758
3869
|
"stale-base": "stale-base";
|
|
3759
3870
|
"empty-result": "empty-result";
|
|
3760
3871
|
unfinished: "unfinished";
|
|
@@ -34,6 +34,12 @@ export const failureKinds = [
|
|
|
34
34
|
'provider-auth',
|
|
35
35
|
'environment',
|
|
36
36
|
'timeout',
|
|
37
|
+
/**
|
|
38
|
+
* Процесс попытки жив, но дольше порога политики (`stallSweep.stalledMs`)
|
|
39
|
+
* не выводил, не расходовал процессор и не закрывал стадий: обход
|
|
40
|
+
* controller остановил его. Действие — повтор или правка среды, не кода.
|
|
41
|
+
*/
|
|
42
|
+
'stalled',
|
|
37
43
|
'stale-base',
|
|
38
44
|
'empty-result',
|
|
39
45
|
/** Исполнитель сообщил `completed: false`: работа не доделана, черновик сохранён. */
|
|
@@ -54,6 +60,36 @@ export const failureKinds = [
|
|
|
54
60
|
'unknown',
|
|
55
61
|
];
|
|
56
62
|
export const failureKindSchema = z.enum(failureKinds);
|
|
63
|
+
/**
|
|
64
|
+
* Живость исполняющейся попытки по периодическому обходу controller
|
|
65
|
+
* (`stallSweep` политики): `active` — движение было недавно, `quiet` — нет
|
|
66
|
+
* движения дольше `quietMs`, `stalled` — дольше `stalledMs`. Движение —
|
|
67
|
+
* вывод процесса, начало или конец его команды, граница стадии
|
|
68
|
+
* (`attempt.stage`), заметный расход процессора деревом процессов.
|
|
69
|
+
*/
|
|
70
|
+
export const livenessStates = ['active', 'quiet', 'stalled'];
|
|
71
|
+
export const livenessStateSchema = z.enum(livenessStates);
|
|
72
|
+
/** Что исполняется: вызов агента, gate, шаг среды или прочая команда попытки. */
|
|
73
|
+
export const activitySchema = z.strictObject({
|
|
74
|
+
kind: z.enum(['agent', 'gate', 'step', 'command']),
|
|
75
|
+
label: z.string().min(1).max(300),
|
|
76
|
+
});
|
|
77
|
+
/** Действие controller на `stalled`: остановить процесс или только сообщить. */
|
|
78
|
+
export const stallActionSchema = z.enum(['stop', 'report']);
|
|
79
|
+
/** Последнее состояние живости попытки; пишется только на переходах. */
|
|
80
|
+
export const attemptLivenessSchema = z.strictObject({
|
|
81
|
+
state: livenessStateSchema,
|
|
82
|
+
/** Время обхода, на котором состояние стало текущим. */
|
|
83
|
+
at: isoTimeSchema,
|
|
84
|
+
/** Последнее замеченное движение. */
|
|
85
|
+
lastMovementAt: isoTimeSchema,
|
|
86
|
+
/** Последняя начатая из исполняющихся команд; нет — команды не идут. */
|
|
87
|
+
activity: activitySchema.optional(),
|
|
88
|
+
/** Только у `stalled`: что controller сделал по политике. */
|
|
89
|
+
action: stallActionSchema.optional(),
|
|
90
|
+
/** Только у `stalled`: файл снимка процессов и хвоста вывода. */
|
|
91
|
+
artifact: z.string().max(1000).optional(),
|
|
92
|
+
});
|
|
57
93
|
/** Значение из отчёта проверки или ответа reviewer: произвольный JSON, сохраняется как есть. */
|
|
58
94
|
const jsonValue = z.lazy(() => z.union([
|
|
59
95
|
z.string(),
|
|
@@ -451,6 +487,8 @@ export const attemptStateSchema = z.strictObject({
|
|
|
451
487
|
wait: z
|
|
452
488
|
.strictObject({ approvedAt: isoTimeSchema.optional(), readyAt: isoTimeSchema.optional() })
|
|
453
489
|
.optional(),
|
|
490
|
+
/** Живость исполняющейся попытки (обход controller); нет — обход её не оценивал. */
|
|
491
|
+
liveness: attemptLivenessSchema.optional(),
|
|
454
492
|
timings: z
|
|
455
493
|
.array(z.strictObject({
|
|
456
494
|
id: z.string().min(1),
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { FailureKind } from './execution.ts';
|
|
2
|
+
import type { EnvironmentCause } from './events.ts';
|
|
2
3
|
/** Отказ окружения до начала работы: попытка не засчитывается. */
|
|
3
4
|
export declare class BlockedError extends Error {
|
|
4
5
|
name: string;
|
|
@@ -22,6 +23,8 @@ export declare class TaskFailure extends Error {
|
|
|
22
23
|
inputClass: string;
|
|
23
24
|
}[];
|
|
24
25
|
} | undefined;
|
|
26
|
+
/** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
|
|
27
|
+
readonly diagnosis?: EnvironmentCause | undefined;
|
|
25
28
|
constructor(kind: FailureKind, message: string,
|
|
26
29
|
/**
|
|
27
30
|
* Свойства, с которыми связан отказ: `bound` — объявленные задачей
|
|
@@ -38,7 +41,9 @@ export declare class TaskFailure extends Error {
|
|
|
38
41
|
property: string;
|
|
39
42
|
inputClass: string;
|
|
40
43
|
}[];
|
|
41
|
-
} | undefined
|
|
44
|
+
} | undefined,
|
|
45
|
+
/** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
|
|
46
|
+
diagnosis?: EnvironmentCause | undefined);
|
|
42
47
|
}
|
|
43
48
|
/**
|
|
44
49
|
* Отпечаток отказа: одинаковые сбои должны совпадать, разные — расходиться.
|
package/lib/contracts/failure.js
CHANGED
|
@@ -7,6 +7,7 @@ export class BlockedError extends Error {
|
|
|
7
7
|
export class TaskFailure extends Error {
|
|
8
8
|
kind;
|
|
9
9
|
properties;
|
|
10
|
+
diagnosis;
|
|
10
11
|
constructor(kind, message,
|
|
11
12
|
/**
|
|
12
13
|
* Свойства, с которыми связан отказ: `bound` — объявленные задачей
|
|
@@ -15,10 +16,13 @@ export class TaskFailure extends Error {
|
|
|
15
16
|
* `classes` — классы входов, названные ревьюером; `pairs` — свойство и
|
|
16
17
|
* класс одной находки.
|
|
17
18
|
*/
|
|
18
|
-
properties
|
|
19
|
+
properties,
|
|
20
|
+
/** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
|
|
21
|
+
diagnosis) {
|
|
19
22
|
super(message);
|
|
20
23
|
this.kind = kind;
|
|
21
24
|
this.properties = properties;
|
|
25
|
+
this.diagnosis = diagnosis;
|
|
22
26
|
this.name = 'TaskFailure';
|
|
23
27
|
}
|
|
24
28
|
}
|