devcontour-harness 0.1.0-alpha.45 → 0.1.0-alpha.47

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 (53) hide show
  1. package/README.md +20 -2
  2. package/docs/architecture.md +8 -0
  3. package/docs/compatibility.md +4 -1
  4. package/docs/contracts.md +25 -5
  5. package/docs/release-notes/0.1.0-alpha.46.md +63 -0
  6. package/docs/release-notes/0.1.0-alpha.47.md +138 -0
  7. package/docs/upgrade.md +119 -19
  8. package/lib/agents/review-probe.js +8 -3
  9. package/lib/contracts/cli.d.ts +11 -0
  10. package/lib/contracts/events.d.ts +13 -1
  11. package/lib/contracts/events.js +2 -0
  12. package/lib/contracts/execution.d.ts +1 -0
  13. package/lib/contracts/execution.js +13 -0
  14. package/lib/contracts/handoff.d.ts +1 -0
  15. package/lib/contracts/handoff.js +6 -1
  16. package/lib/contracts/ports.d.ts +54 -0
  17. package/lib/contracts/published.d.ts +8 -0
  18. package/lib/contracts/report.d.ts +4 -0
  19. package/lib/control/harness.d.ts +1 -1
  20. package/lib/control/workflow.d.ts +5 -1
  21. package/lib/control/workflow.js +18 -3
  22. package/lib/engine/classify.d.ts +6 -0
  23. package/lib/engine/classify.js +26 -0
  24. package/lib/engine/engine.d.ts +25 -2
  25. package/lib/engine/engine.js +76 -7
  26. package/lib/engine/runner.d.ts +11 -6
  27. package/lib/engine/runner.js +107 -34
  28. package/lib/environment/host-load.d.ts +12 -0
  29. package/lib/environment/host-load.js +7 -0
  30. package/lib/environment/lifecycle.d.ts +12 -1
  31. package/lib/environment/lifecycle.js +19 -2
  32. package/lib/environment/process.d.ts +71 -1
  33. package/lib/environment/process.js +149 -31
  34. package/lib/handoff/pack.js +7 -1
  35. package/lib/index.d.ts +5 -1
  36. package/lib/index.js +7 -1
  37. package/lib/report/document.js +2 -0
  38. package/lib/storage/sqlite.d.ts +47 -4
  39. package/lib/storage/sqlite.js +279 -34
  40. package/lib/testing/store-contract.d.ts +9 -0
  41. package/lib/testing/store-contract.js +235 -0
  42. package/lib/verification/applicability.d.ts +25 -2
  43. package/lib/verification/applicability.js +34 -1
  44. package/lib/verification/gates-at.js +15 -1
  45. package/lib/verification/gates.d.ts +3 -10
  46. package/lib/verification/gates.js +136 -15
  47. package/lib/verification/reaped.d.ts +24 -0
  48. package/lib/verification/reaped.js +24 -0
  49. package/package.json +1 -1
  50. package/schemas/execution-document.schema.json +4 -0
  51. package/schemas/handoff-pack.schema.json +4 -0
  52. package/schemas/run-event.schema.json +2 -0
  53. package/schemas/value-report.schema.json +3 -1
@@ -1,4 +1,4 @@
1
- import { type ExecutionPolicy, type ContractDocument, type GateApplicability, type GatePolicy, type WorkOrder } from '../contracts/index.ts';
1
+ import { type ExecutionPolicy, type ContractDocument, type AttemptState, type GateApplicability, type GatePolicy, type WorkOrder } from '../contracts/index.ts';
2
2
  /**
3
3
  * Применимость gate с `when.paths`. Решение принимает controller по
4
4
  * настоящему diff фазы из Git, а не по заявлению исполнителя. Правило
@@ -75,6 +75,20 @@ export declare function pathApplicability(repo: {
75
75
  * обязательства). Их доказательство — только исполнение.
76
76
  */
77
77
  export declare function proofGates(order: Pick<WorkOrder, 'requirements' | 'properties'>, contracts: readonly ContractDocument[]): Set<string>;
78
+ /** Снимок провайдера, против которого шла попытка (`AttemptState.dependencies`). */
79
+ export type ProviderSnapshot = Pick<NonNullable<AttemptState['dependencies']>[number], 'repositoryId' | 'sha'>;
80
+ /**
81
+ * Почему база провайдеров сдвинулась с зелёного SHA gate, или undefined.
82
+ * Провайдеры — `dependsOn` репозитория и все репозитории снимков (в том числе
83
+ * транзитивные). Сдвиг — другой SHA провайдера; снимок провайдера, которого
84
+ * нет у зелёной попытки или у текущей (запись прежней версии, новый
85
+ * провайдер), — тоже сдвиг: изменение провайдера меняет вход gate
86
+ * потребителя, даже если diff потребителя не задел его путей. Artifacts
87
+ * провайдера не сравниваются: их пересобирают в каждой попытке, и
88
+ * невоспроизводимая сборка давала бы сдвиг на каждой; при том же SHA их
89
+ * вход — тот же источник.
90
+ */
91
+ export declare function providerMovement(providers: readonly string[], green: readonly ProviderSnapshot[] | undefined, current: readonly ProviderSnapshot[] | undefined): string | undefined;
78
92
  export interface GateDecisionInput {
79
93
  repo: {
80
94
  gates: GatePolicy[];
@@ -88,6 +102,14 @@ export interface GateDecisionInput {
88
102
  * SHA фазы; undefined — такого SHA нет, и gate исполняется.
89
103
  */
90
104
  changedFor(gate: GatePolicy): ChangedPaths | undefined;
105
+ /**
106
+ * Почему база провайдеров сдвинулась с того же зелёного SHA
107
+ * (`providerMovement`), или undefined. Спрашивается только у условного gate
108
+ * с зелёным SHA. Без поля провайдеры считаются не сдвинувшимися: вызывающий
109
+ * ручается, что `changedFor` даёт зелёный SHA только под теми же SHA
110
+ * провайдеров (или что провайдеров нет). Runner его передаёт всегда.
111
+ */
112
+ providersMoved?(gate: GatePolicy): string | undefined;
91
113
  /** `proofGates` поручения. */
92
114
  proof: ReadonlySet<string>;
93
115
  }
@@ -100,7 +122,8 @@ export interface GateDecision {
100
122
  /**
101
123
  * Решения по области фазы. Gate без `when` исполняется всегда. Условный
102
124
  * исполняется, если: он доказывает требование или договор; среди предков
103
- * базы нет его зелёного SHA под тем же основанием (`changedFor`); diff
125
+ * базы нет его зелёного SHA под тем же основанием (`changedFor`); с этого
126
+ * зелёного SHA сдвинулась база провайдеров (`providersMoved`); diff
104
127
  * неизвестен, пуст или задевает его путь или неявный вход; он — предпосылка
105
128
  * (`gatePrerequisites`: `dependsOn` или более ранний check gate) исполняемого
106
129
  * gate области. Иначе — запись `not-applicable`.
@@ -293,10 +293,40 @@ export function proofGates(order, contracts) {
293
293
  }
294
294
  return out;
295
295
  }
296
+ /**
297
+ * Почему база провайдеров сдвинулась с зелёного SHA gate, или undefined.
298
+ * Провайдеры — `dependsOn` репозитория и все репозитории снимков (в том числе
299
+ * транзитивные). Сдвиг — другой SHA провайдера; снимок провайдера, которого
300
+ * нет у зелёной попытки или у текущей (запись прежней версии, новый
301
+ * провайдер), — тоже сдвиг: изменение провайдера меняет вход gate
302
+ * потребителя, даже если diff потребителя не задел его путей. Artifacts
303
+ * провайдера не сравниваются: их пересобирают в каждой попытке, и
304
+ * невоспроизводимая сборка давала бы сдвиг на каждой; при том же SHA их
305
+ * вход — тот же источник.
306
+ */
307
+ export function providerMovement(providers, green, current) {
308
+ const ids = [
309
+ ...new Set([
310
+ ...providers,
311
+ ...(green ?? []).map((d) => d.repositoryId),
312
+ ...(current ?? []).map((d) => d.repositoryId),
313
+ ]),
314
+ ].sort();
315
+ for (const id of ids) {
316
+ const from = green?.find((d) => d.repositoryId === id);
317
+ const to = current?.find((d) => d.repositoryId === id);
318
+ if (!from || !to)
319
+ return `снимок провайдера ${id} ${from ? 'попытки' : 'зелёного SHA'} неизвестен`;
320
+ if (from.sha !== to.sha)
321
+ return `база провайдера ${id} сдвинулась: ${from.sha.slice(0, 12)} → ${to.sha.slice(0, 12)}`;
322
+ }
323
+ return undefined;
324
+ }
296
325
  /**
297
326
  * Решения по области фазы. Gate без `when` исполняется всегда. Условный
298
327
  * исполняется, если: он доказывает требование или договор; среди предков
299
- * базы нет его зелёного SHA под тем же основанием (`changedFor`); diff
328
+ * базы нет его зелёного SHA под тем же основанием (`changedFor`); с этого
329
+ * зелёного SHA сдвинулась база провайдеров (`providersMoved`); diff
300
330
  * неизвестен, пуст или задевает его путь или неявный вход; он — предпосылка
301
331
  * (`gatePrerequisites`: `dependsOn` или более ранний check gate) исполняемого
302
332
  * gate области. Иначе — запись `not-applicable`.
@@ -314,6 +344,9 @@ export function gateDecisions(input) {
314
344
  run: true,
315
345
  reason: 'нет зелёного SHA gate под тем же основанием среди предков базы',
316
346
  };
347
+ const moved = input.providersMoved?.(gate);
348
+ if (moved)
349
+ return { gate, run: true, reason: moved };
317
350
  const path = pathApplicability(input.repo, gate, changed);
318
351
  return path.applies
319
352
  ? { gate, run: true, reason: path.reason }
@@ -8,7 +8,7 @@ import { git } from "../environment/process.js";
8
8
  import { executionEnvironment, preparation, preparesTree, runSteps, withEnvironment, } from "../environment/lifecycle.js";
9
9
  import { defaultResourceDatabase, withResources } from "../environment/resources.js";
10
10
  import { removeSnapshots, snapshotDependencies } from "./dependencies.js";
11
- import { runGate } from "./gates.js";
11
+ import { reapedFailure, runGate } from "./gates.js";
12
12
  import { checkoutPath, chooseCheckoutRoot } from "../environment/checkout-root.js";
13
13
  import { dependencyStoreRoot, materializeStore } from "./dependency-store.js";
14
14
  import { credentialPaths } from "../environment/isolation.js";
@@ -151,11 +151,23 @@ async function gatesAt(ctx, input) {
151
151
  await materializeStore(store, { repo, cwd, execution, signal, dir: artifacts });
152
152
  await runSteps(repo.prepare, cwd, join(artifacts, 'prepare'), execution, signal);
153
153
  prepared(execution);
154
+ let reapedBy;
154
155
  for (const gate of gates) {
155
156
  // Пропускается только gate, чья явная предпосылка (`dependsOn`) не
156
157
  // прошла. Провал неявной (более ранний check gate в режиме
157
158
  // порядка массива) не скрывает исход тестов: исполняются и
158
159
  // названы оба.
160
+ // Потомки прежнего gate не остановлены: следующие gates в этом
161
+ // дереве не исполняются — их evidence записывалось бы рядом с
162
+ // живым писателем.
163
+ if (reapedBy) {
164
+ failed.add(gate.id);
165
+ failures.push({
166
+ gate: gate.id,
167
+ message: `не исполнен: потомки проверки ${reapedBy} не остановлены, дерево не используется`,
168
+ });
169
+ continue;
170
+ }
159
171
  const blocked = explicitPrerequisites(repo.gates, gate.id).filter((g) => failed.has(g));
160
172
  if (blocked.length) {
161
173
  failed.add(gate.id);
@@ -211,6 +223,8 @@ async function gatesAt(ctx, input) {
211
223
  throw error;
212
224
  failed.add(gate.id);
213
225
  failures.push({ gate: gate.id, message: stalledBy(input.signal) ?? error.message });
226
+ if (reapedFailure(error))
227
+ reapedBy = gate.id;
214
228
  }
215
229
  }
216
230
  });
@@ -1,3 +1,4 @@
1
+ import { hostLoad, type HostLoad } from '../environment/host-load.ts';
1
2
  import { type Activity, type EvidenceRecord, type ExecutionPolicy, type GatePolicy } from '../contracts/index.ts';
2
3
  import { isolationSupport, type Isolation, type SandboxViolation } from '../environment/isolation.ts';
3
4
  import { TaskFailure } from '../engine/failure.ts';
@@ -190,22 +191,14 @@ export interface Boundary {
190
191
  * укладывается в предел, повтора не получает.
191
192
  */
192
193
  export declare const HOST_LOAD_RECHECK_PER_CPU = 2;
193
- /** Снимок нагрузки хоста; объект — чтобы тест мог подменить чтение. */
194
- export declare const hostLoad: {
195
- read: () => HostLoad;
196
- };
197
- export interface HostLoad {
198
- /** Средняя нагрузка за минуту (`os.loadavg()[0]`; на Windows — 0). */
199
- load1: number;
200
- /** Доступные процессу ядра. */
201
- cpus: number;
202
- }
194
+ export { hostLoad, type HostLoad };
203
195
  /**
204
196
  * Gate исчерпал свой предел времени (не отмена попытки). Класс отказа —
205
197
  * прежний `gate`; нагрузка в момент таймаута решает, повторить ли gate один
206
198
  * раз (`Runner`): повтор прошёл — исход `flaky`, попытка не тратится; снова
207
199
  * таймаут — провал засчитан как прежде.
208
200
  */
201
+ export { ReapedGate, reapedFailure } from './reaped.ts';
209
202
  export declare class GateTimeout extends TaskFailure {
210
203
  readonly load: HostLoad;
211
204
  constructor(message: string, load: HostLoad);
@@ -1,11 +1,12 @@
1
1
  import { readFile, readdir, writeFile, mkdir, mkdtemp, rm, realpath, lstat, chmod, } from 'node:fs/promises';
2
- import { availableParallelism, loadavg, tmpdir } from 'node:os';
2
+ import { tmpdir } from 'node:os';
3
+ import { hostLoad, loadText } from "../environment/host-load.js";
3
4
  import { join, resolve, sep, delimiter, relative, dirname } from 'node:path';
4
5
  import { accessSync, constants, existsSync } from 'node:fs';
5
6
  import { createHash, randomUUID } from 'node:crypto';
6
7
  import { XMLParser, XMLValidator } from 'fast-xml-parser';
7
8
  import { sha256, gateTimeoutMs, gateTimeoutText, } from "../contracts/index.js";
8
- import { command, git, gitOutput } from "../environment/process.js";
9
+ import { ReapFailure, command, git, gitOutput } from "../environment/process.js";
9
10
  import { isolation, isolatedCommand, srtTempDir, isolationSupport, protectedChanges, protectedSnapshot, SandboxPolicyError, sandboxDenials, snapshotLimit, watchSandboxLog, } from "../environment/isolation.js";
10
11
  import { UntrustedCheckoutError } from "../environment/git-trust.js";
11
12
  import { TaskFailure } from "../engine/failure.js";
@@ -13,6 +14,7 @@ import { redactDeep } from "../environment/redaction.js";
13
14
  import { dependencyNetworkFailure, dependencyNetworkMessage, isDependencyInstall, } from "../environment/dependency-network.js";
14
15
  import { expectsReference, manifestDigest, propertyCoverage, propertyFailure, propertySeed, readPropertyReport, } from "./property.js";
15
16
  import { keepGateArtifacts } from "./gate-artifacts.js";
17
+ import { ReapedGate } from "./reaped.js";
16
18
  /** Длинное имя testcase заменяется хешем, а не обрезается: обрезка дала бы ложные совпадения. */
17
19
  export const TEST_ID_LIMIT = 1000;
18
20
  export function portableTest(test) {
@@ -345,6 +347,10 @@ h, options) {
345
347
  const marks = await realpath(await mkdtemp(join(tmpdir(), 'dc-start-')));
346
348
  // Свой короткий временный каталог srt (`srtTempDir`), если его пришлось создать.
347
349
  let srtTemp;
350
+ /** Отказ тела проверки: уборка его не заменяет. */
351
+ let thrown;
352
+ /** Первый запуск, чьи потомки не остановлены или не пересчитаны. */
353
+ let reaped;
348
354
  try {
349
355
  if (h.config.isolation.mode === 'os') {
350
356
  const support = isolationBackend.check();
@@ -407,6 +413,19 @@ h, options) {
407
413
  // Каталоги проверки принадлежат только ей: процесс, запущенный в них
408
414
  // во время проверки, — её потомок, даже без метки и родства.
409
415
  contain: { dirs: [...options.write, scratch, marks] },
416
+ }).catch((error) => {
417
+ // Потомки запуска не остановлены или не пересчитаны: его исход
418
+ // разбирается как обычно (повтор не стартовавшей песочницы, журнал
419
+ // отказов ядра), а отказ остановки выносится в конце с полным исходом.
420
+ if (error instanceof ReapFailure && error.result) {
421
+ // Текст и исход — последнего запуска (того, что стартовал);
422
+ // потомки прежних не стартовавших запусков не забываются.
423
+ reaped = reaped
424
+ ? new ReapFailure(error.message, [...new Set([...reaped.survivors, ...error.survivors])], error.inventory ?? reaped.inventory, error.result)
425
+ : error;
426
+ return error.result;
427
+ }
428
+ throw error;
410
429
  });
411
430
  };
412
431
  try {
@@ -433,7 +452,7 @@ h, options) {
433
452
  // Без песочницы завершившийся процесс точно порождался.
434
453
  if (started === undefined)
435
454
  confirm();
436
- return {
455
+ const outcome = {
437
456
  ...result,
438
457
  attempts,
439
458
  started: launched,
@@ -442,6 +461,17 @@ h, options) {
442
461
  ...(policy ? { isolation: policy } : {}),
443
462
  ...(violations ? { violations } : {}),
444
463
  };
464
+ // Исход проверки — вместе с отказом остановки (`completedCheck`): её
465
+ // класс решает вызывающий, успехом она не станет.
466
+ if (reaped)
467
+ throw Object.assign(reaped, { [checkResult]: outcome });
468
+ return outcome;
469
+ }
470
+ catch (error) {
471
+ // Отказ самой проверки (в том числе неостановленные потомки) — её исход:
472
+ // отказ уборки ниже его не заменяет, а дописывается к нему.
473
+ thrown = { error };
474
+ throw error;
445
475
  }
446
476
  finally {
447
477
  // Наблюдение за журналом не переживает проверку и при исключении.
@@ -456,9 +486,25 @@ h, options) {
456
486
  ]);
457
487
  const failed = removed.find((r) => r.status === 'rejected');
458
488
  if (failed) {
489
+ const error = failed.reason instanceof Error ? failed.reason : new Error(String(failed.reason));
490
+ // Проверка уже отказала: её отказ остаётся первичным — с классом,
491
+ // причиной и исходом. Неостановленные потомки, мешающие уборке, —
492
+ // частый случай: ReapFailure не должна стать «провалом gate».
493
+ if (thrown) {
494
+ const original = thrown.error;
495
+ if (original instanceof ReapFailure) {
496
+ const extended = original.extend(leftoverText(error.message));
497
+ const done = completedCheck(original);
498
+ throw done ? Object.assign(extended, { [checkResult]: done }) : extended;
499
+ }
500
+ if (original instanceof Error) {
501
+ original.message += `; ${leftoverText(error.message)}`;
502
+ throw original;
503
+ }
504
+ throw original;
505
+ }
459
506
  // Отказ уборки после завершения не стирает исход проверки: код и
460
507
  // вывод доступны вызывающему через ошибку (`completedCheck`).
461
- const error = failed.reason instanceof Error ? failed.reason : new Error(String(failed.reason));
462
508
  throw result
463
509
  ? Object.assign(error, {
464
510
  [checkResult]: {
@@ -476,6 +522,7 @@ h, options) {
476
522
  }
477
523
  }
478
524
  const checkResult = Symbol('runCheck.result');
525
+ const leftoverText = (reason) => `временные каталоги проверки не убраны: ${reason}`;
479
526
  /** Исход проверки, завершившейся до исключения (например, отказа уборки), если он есть. */
480
527
  export function completedCheck(error) {
481
528
  return error && typeof error === 'object' && checkResult in error
@@ -529,17 +576,17 @@ export function freshnessEnv(kind, env) {
529
576
  * укладывается в предел, повтора не получает.
530
577
  */
531
578
  export const HOST_LOAD_RECHECK_PER_CPU = 2;
532
- /** Снимок нагрузки хоста; объект — чтобы тест мог подменить чтение. */
533
- export const hostLoad = {
534
- read: () => ({ load1: loadavg()[0] ?? 0, cpus: Math.max(1, availableParallelism()) }),
535
- };
536
- const loadText = (load) => `нагрузка хоста ${Math.round(load.load1 * 10) / 10} на ${load.cpus} ядер`;
579
+ // Снимок нагрузки хоста — общий с containment команд (`host-load.ts`).
580
+ export { hostLoad };
537
581
  /**
538
582
  * Gate исчерпал свой предел времени (не отмена попытки). Класс отказа —
539
583
  * прежний `gate`; нагрузка в момент таймаута решает, повторить ли gate один
540
584
  * раз (`Runner`): повтор прошёл — исход `flaky`, попытка не тратится; снова
541
585
  * таймаут — провал засчитан как прежде.
542
586
  */
587
+ // Отказ gate с неостановленными потомками — в лёгком модуле: его знает и
588
+ // классификация отказов (`withSuffix`).
589
+ export { ReapedGate, reapedFailure } from "./reaped.js";
543
590
  export class GateTimeout extends TaskFailure {
544
591
  load;
545
592
  constructor(message, load) {
@@ -629,6 +676,12 @@ export async function runGate(run) {
629
676
  let timedOutFailures = '';
630
677
  // Заголовок лога — фактические каталог и argv запуска: digest лога входит в
631
678
  // evidence, и запись называет, где и чем проверка исполнялась.
679
+ /** Отказ уборки каталогов завершившейся проверки (`completedCheck`). */
680
+ let leftover;
681
+ /** Команда завершилась, но её потомки не остановлены или не пересчитаны. */
682
+ let reaped;
683
+ /** Провал назван только ненулевым кодом выхода, без иной причины. */
684
+ let exitOnly = false;
632
685
  let passed = false, summary = '', log = `# harness gate ${gate.id}: cwd=${relative(root, gateCwd) || '.'} argv=${JSON.stringify(gate.command.map(redact))}${gate.kind === 'test' ? ` fresh=${redact(JSON.stringify(freshness))}` : ''}\n`, exitCode = -1, manifest;
633
686
  try {
634
687
  // Снимок защищённых путей до проверки: запреты песочницы видят только
@@ -662,6 +715,20 @@ export async function runGate(run) {
662
715
  ...(run.boundary.checkouts?.length ? { checkouts: run.boundary.checkouts } : {}),
663
716
  settingsDir: join(artifactDir, gate.id),
664
717
  violations: true,
718
+ }).catch((error) => {
719
+ // Проверка завершилась, но её временные каталоги не убраны или её
720
+ // потомки не остановлены (`ReapFailure` с исходом runCheck: старт
721
+ // песочницы, отказы ядра): исход разбирается как обычно (провал,
722
+ // который назвала команда, — свидетельство о коде; отказ песочницы —
723
+ // отказ среды), отказ дописывается к нему, успехом проверка не станет.
724
+ const done = completedCheck(error);
725
+ if (!done)
726
+ throw error;
727
+ if (error instanceof ReapFailure)
728
+ reaped = error;
729
+ else
730
+ leftover = error instanceof Error ? error.message : String(error);
731
+ return done;
665
732
  });
666
733
  exitCode = result.code;
667
734
  log += result.stdout + '\n' + result.stderr;
@@ -765,6 +832,8 @@ export async function runGate(run) {
765
832
  cause = 'dependency-network';
766
833
  throw new Error(dependencyNetworkMessage(redact(network), `Код выхода ${result.code}: ${diagnostic(result.stderr, result.stdout, redact)}`));
767
834
  }
835
+ // Провал назван только кодом выхода (без упавших случаев отчёта).
836
+ exitOnly = !counts?.failures;
768
837
  throw new Error([
769
838
  `Код выхода ${result.code}`,
770
839
  counts?.failures ? `упали ${failedCases(counts)}` : '',
@@ -787,6 +856,19 @@ export async function runGate(run) {
787
856
  throw new Error('Gate изменил HEAD');
788
857
  if (await git(cwd, 'status', '--porcelain', '--untracked-files=no'))
789
858
  throw new Error('Gate изменил отслеживаемые файлы');
859
+ // Проверка прошла, но controller не убрал её каталоги (scratch, метки
860
+ // старта, временный каталог srt — вне worktree): о коде это ничего не
861
+ // говорит, это отказ среды `cleanup`. Проверка всё равно не пройдена:
862
+ // зелёный исход без уборки не принимается.
863
+ // Проверка прошла, но её потомки не остановлены: зелёный исход рядом с
864
+ // живым писателем не принимается — отказ среды `process-reap`.
865
+ if (reaped)
866
+ throw reaped;
867
+ if (leftover) {
868
+ kind = 'environment';
869
+ cause = 'cleanup';
870
+ throw new Error(`${summary}, но ${leftoverText(leftover)}`);
871
+ }
790
872
  passed = true;
791
873
  }
792
874
  catch (error) {
@@ -798,10 +880,29 @@ export async function runGate(run) {
798
880
  }
799
881
  if (error instanceof UntrustedCheckoutError)
800
882
  kind = 'scope-violation';
801
- const message = error instanceof Error ? error.message : String(error);
883
+ // Процессы проверки не удалось остановить или пересчитать: о коде это
884
+ // ничего не говорит — отказ среды. Проверка при этом не пройдена, и
885
+ // повтора на том же дереве нет (повтор интеграции — только у `gate`):
886
+ // потомок, возможно, ещё пишет в worktree.
887
+ if (error instanceof ReapFailure) {
888
+ kind = 'environment';
889
+ cause = 'process-reap';
890
+ reaped = error;
891
+ }
892
+ let message = error instanceof Error ? error.message : String(error);
893
+ // Провал, названный самой командой, остаётся первичным; неостановленные
894
+ // потомки дописываются к нему (правило то же, что у неубранных каталогов).
895
+ if (reaped && error !== reaped)
896
+ message += `; ${reaped.message}`;
897
+ // Провал самой проверки остаётся её классом; неубранные каталоги — к нему.
898
+ if (leftover && cause !== 'cleanup')
899
+ message += `; ${leftoverText(leftover)}`;
802
900
  summary = redact(message);
803
901
  log += '\n' + summary;
804
902
  }
903
+ // Сводка после разбора исхода команды: любая причина, дописанная позже
904
+ // (свойства, покрытие, отчёт, корпус, уборка), — уже не «только код выхода».
905
+ const caughtSummary = summary;
805
906
  // Отчёт свойств читается при любом исходе: провал и таймаут — ровно те
806
907
  // случаи, когда контрпример и вход нужны больше всего.
807
908
  let propertyEvidence;
@@ -948,15 +1049,31 @@ export async function runGate(run) {
948
1049
  ];
949
1050
  const declared = new Set(expected?.properties.map((p) => p.id) ?? []);
950
1051
  const message = `${phase}/${run.consumer ? run.consumer + ':' : ''}${gate.id}: ${evidence.summary}`;
951
- // Таймаут без контрпримера свойства: повтор на том же SHA решает `Runner`.
952
- if (timedOut && kind === 'gate' && !failing.length && !timedOutFailures)
953
- throw new GateTimeout(message, timedOut);
954
- throw new TaskFailure(kind, message, failing.length
1052
+ const properties = failing.length
955
1053
  ? {
956
1054
  bound: [...new Set(failing.filter((id) => declared.has(id)))],
957
1055
  unbound: [...new Set(failing.filter((id) => !declared.has(id)))],
958
1056
  }
959
- : undefined, kind === 'environment' ? cause : undefined);
1057
+ : undefined;
1058
+ if (reaped) {
1059
+ // Потомки команды не остановлены. Провал, который назвала команда
1060
+ // (код выхода, упавшие тесты, контрпример свойства), — свидетельство о
1061
+ // коде: класс `gate`, засчитывается, неостановленные потомки дописаны.
1062
+ // Таймаут и прерывание без названного провала о коде не говорят —
1063
+ // отказ среды. В обоих случаях повтора на этом дереве нет (`ReapedGate`).
1064
+ const named = failing.length > 0 || timedOutFailures !== '';
1065
+ if (named)
1066
+ kind = 'gate';
1067
+ else if (kind === 'gate' && (timedOut || signal.aborted)) {
1068
+ kind = 'environment';
1069
+ cause = 'process-reap';
1070
+ }
1071
+ throw Object.assign(new ReapedGate(kind, message, properties, kind === 'environment' ? cause : undefined), { exitOnly: kind === 'gate' && exitOnly && !named && summary === caughtSummary });
1072
+ }
1073
+ // Таймаут без контрпримера свойства: повтор на том же SHA решает `Runner`.
1074
+ if (timedOut && kind === 'gate' && !failing.length && !timedOutFailures)
1075
+ throw new GateTimeout(message, timedOut);
1076
+ throw new TaskFailure(kind, message, properties, kind === 'environment' ? cause : undefined);
960
1077
  }
961
1078
  return evidence;
962
1079
  }
@@ -1131,6 +1248,10 @@ export async function prepareWriterDependencies(run) {
1131
1248
  // Отказ сборки политики песочницы — отказ среды, как у gate.
1132
1249
  if (error instanceof SandboxPolicyError)
1133
1250
  throw new TaskFailure('environment', error.message, undefined, 'sandbox-policy');
1251
+ // Потомки установки не остановлены: исполнитель не получает дерево, в
1252
+ // котором они, возможно, ещё пишут, — попытка кончается отказом среды.
1253
+ if (error instanceof ReapFailure)
1254
+ throw error;
1134
1255
  failure = redact(error instanceof Error ? error.message : String(error));
1135
1256
  }
1136
1257
  signal.throwIfAborted();
@@ -0,0 +1,24 @@
1
+ import { TaskFailure } from '../contracts/index.ts';
2
+ import { ReapFailure } from '../environment/process.ts';
3
+ /**
4
+ * Отказ gate, чьи потомки не остановлены или не пересчитаны: дерево, где он
5
+ * исполнялся, больше не используется — ни повтора gate на нём, ни следующих
6
+ * проверок. Класс — `environment`/`process-reap` или `gate`, если команда
7
+ * сама назвала провал.
8
+ */
9
+ export declare class ReapedGate extends TaskFailure {
10
+ name: string;
11
+ /**
12
+ * Провал `gate` назван только ненулевым кодом выхода: ни упавшего или
13
+ * пропущенного теста, ни свойства, покрытия, отчёта, корпуса, ни правки
14
+ * HEAD или отслеживаемых файлов. Только такой провал интеграции после
15
+ * прошедшего кандидата считается перегрузкой хоста.
16
+ */
17
+ exitOnly: boolean;
18
+ /** Тот же отказ с дописанной причиной; признак неостановленных потомков сохраняется. */
19
+ extend(suffix: string): ReapedGate & {
20
+ exitOnly: boolean;
21
+ };
22
+ }
23
+ /** Отказ, после которого в дереве проверки, возможно, ещё работают её потомки. */
24
+ export declare const reapedFailure: (error: unknown) => error is ReapFailure | ReapedGate;
@@ -0,0 +1,24 @@
1
+ import { TaskFailure } from "../contracts/index.js";
2
+ import { ReapFailure } from "../environment/process.js";
3
+ /**
4
+ * Отказ gate, чьи потомки не остановлены или не пересчитаны: дерево, где он
5
+ * исполнялся, больше не используется — ни повтора gate на нём, ни следующих
6
+ * проверок. Класс — `environment`/`process-reap` или `gate`, если команда
7
+ * сама назвала провал.
8
+ */
9
+ export class ReapedGate extends TaskFailure {
10
+ name = 'ReapedGate';
11
+ /**
12
+ * Провал `gate` назван только ненулевым кодом выхода: ни упавшего или
13
+ * пропущенного теста, ни свойства, покрытия, отчёта, корпуса, ни правки
14
+ * HEAD или отслеживаемых файлов. Только такой провал интеграции после
15
+ * прошедшего кандидата считается перегрузкой хоста.
16
+ */
17
+ exitOnly = false;
18
+ /** Тот же отказ с дописанной причиной; признак неостановленных потомков сохраняется. */
19
+ extend(suffix) {
20
+ return Object.assign(new ReapedGate(this.kind, `${this.message}; ${suffix}`, this.properties, this.diagnosis, this.contextLimit), { exitOnly: this.exitOnly });
21
+ }
22
+ }
23
+ /** Отказ, после которого в дереве проверки, возможно, ещё работают её потомки. */
24
+ export const reapedFailure = (error) => error instanceof ReapedGate || error instanceof ReapFailure;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devcontour-harness",
3
- "version": "0.1.0-alpha.45",
3
+ "version": "0.1.0-alpha.47",
4
4
  "description": "Headless execution harness: work graph, isolated attempts, gates, independent reviews and accepted results.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -4643,6 +4643,10 @@
4643
4643
  ],
4644
4644
  "additionalProperties": false
4645
4645
  },
4646
+ "leaseRows": {
4647
+ "type": "boolean",
4648
+ "const": true
4649
+ },
4646
4650
  "sequence": {
4647
4651
  "type": "integer",
4648
4652
  "minimum": 0,
@@ -1203,6 +1203,10 @@
1203
1203
  "type": "string",
1204
1204
  "pattern": "^[A-Za-z0-9_-]{1,80}$"
1205
1205
  },
1206
+ "key": {
1207
+ "type": "string",
1208
+ "pattern": "^[a-f0-9]{64}$"
1209
+ },
1206
1210
  "status": {
1207
1211
  "type": "string",
1208
1212
  "maxLength": 40
@@ -1214,6 +1214,8 @@
1214
1214
  "lease-expired",
1215
1215
  "stalled",
1216
1216
  "shutdown",
1217
+ "process-reap",
1218
+ "cleanup",
1217
1219
  "other",
1218
1220
  "none"
1219
1221
  ]
@@ -2238,7 +2238,7 @@
2238
2238
  "type": "object",
2239
2239
  "properties": {
2240
2240
  "rows": {
2241
- "maxItems": 14,
2241
+ "maxItems": 16,
2242
2242
  "type": "array",
2243
2243
  "items": {
2244
2244
  "type": "object",
@@ -2258,6 +2258,8 @@
2258
2258
  "lease-expired",
2259
2259
  "stalled",
2260
2260
  "shutdown",
2261
+ "process-reap",
2262
+ "cleanup",
2261
2263
  "other",
2262
2264
  "none"
2263
2265
  ]